Microsoft Windows CE 3.0  

HWInit

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

© 2004 Microsoft Corporation. All rights reserved.