HWInit (Windows Embedded CE 6.0)

1/6/2010

This function initializes a serial device.

Syntax

PVOID HWInit(
  ULONG Identifier,
  PVOID pMDDContext,
  PHWOBJ pHWObj
);

Parameters

• Identifier
  [in] LPCWSTR that contains the registry key of the active device.

• pMDDContext
  [in] Pointer to a device context used on all function calls to the device driver.

• pHWObj
  [in] Pointer to an HWOBJ structure returned by GetSerialObject.

Return Value

A pointer to a context structure that contains implementation-specific data describing the 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 exposed only to the upper layer, and is called only once — when the device driver loads 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 supports the implementation of the lower layers of serial port drivers.

Requirements

See Also

Reference

Serial Port Driver PDD Functions
COM_Init
GetSerialObject
HWOBJ