HWInit

This function initializes a serial device.

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 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 upper layer, 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 supports the implementation of the lower layers of serial port drivers.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Serhw.h.

See Also

COM_Init | GetSerialObject | HWOBJ

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.