HWInit

This function initializes a serial device.

Syntax

PVOID HWInit( ULONG Identifier, PVOID pMDDContext );

Parameters

Identifier

An LPCWSTR that 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.

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_Init function. 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. This function is defined in the header file SerHW.h, and is available in Windows CE version 1.0 and later.