 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function initializes a serial device. In Windows CE 2.12 and earlier, HWInithad this prototype:
PVOID HWInit( ULONG Identifier, PVOID pMDDContext );
Parameters
- Identifier
- An LPCWSTRthat contains the registry key of the active device.
- pMDDContext
- Pointer to a device context used on all function calls to the
device driver.
Return Values
A pointer to a context structure that contains implementation-specific data describing the hardware device.
In Windows CE 3.0 and later, serial port drivers that use the new serial port MDD layer should use the following prototype for HWInit:
PVOID HWInit( ULONG Identifier, PVOID pMDDContext, PHWOBJ pHWObj);
Parameters
- Identifier
- An LPCWSTRthat contains the registry key of the active device.
- pMDDContext
- Pointer to a device context used on all function calls to the device driver.
- pHWObj
- A pointer to an
HWOBJstructure returned by
GetSerialObject.
Return Values
A pointer to a context structure that contains implementation-specific data describing the hardware device.
Remarks
This function sets information controlled by the user, such as line control and baud rate. It can also initialize events and interrupts, indirectly managing the initializing of hardware buffers. It is exported only to the MDD, and it is called only once when the device driver is loaded in response to a call to the COM_Initfunction. For built-in devices, this occurs at boot time. For PC Cards, this occurs when a card is inserted.
This function is part of the implementation of the PDDs of serial port drivers.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Serhw.h Note This information applies to the version of Windows CE as provided by Microsoft. Actual implementation is determined by OEMs, and some Windows CE-based platforms may not support this function.
Last updated on Tuesday, July 13, 2004