Epson Research and Development
Page 107
Vancouver Design Center
14.2 Initialization
Initialization functions are normally the first functions in the HAL library that an appli-
cation calls. These routine allow the application to learn a little about the controller and to
prepare the HAL library for use.
int seRegisterDevice(const LPHAL_STRUC lpHalInfo)
Description:
This function registers the S1D13506 device parameters with the HAL library. The device
parameters include such item as address range, register values, desired frame rate, and
more which are stored in the HAL_STRUCT structure pointed to by lpHalInfo. Addition-
ally this routine allocates system memory as address space for accessing registers and the
display buffer.
Parameters:
lpHalInfo
A pointer to a HAL_STRUCT structure. This structure
must be filled with appropriate values prior to calling
seRegisterDevice.
Return Value:
ERR_OK
operation completed with no problems
ERR_UNKNOWN_DEVICE The HAL was unable to locate the S1D13506.
ERR_FAILED
The HAL was unable to map S1D13506 display memory
to the host platform.
In addition, on Win32 platforms, the following two error values may be returned:
ERR_PCI_DRIVER_-
NOT_FOUND
The HAL was unable to locate file S1D13X0X.VXD
ERR_PCI_BRIDGE_-
The driver file S1D13X0X.VXD was unable to locate the
ADAPTER_NOT_FOUND S1D13506.
Note
seRegisterDevice() MUST be called before any other HAL functions.
Programming Notes and Examples
Issue Date: 01/02/06
S1D13506
X25B-G-003-03