HcdMdd_CreateHcdObject (Windows Embedded CE 6.0)

1/6/2010

This function creates and initializes a host controller interface (HCI) driver object.

Syntax

LPVOID HcdMdd_CreateHcdObject(
  LPVOID lpvOhcdPddObject,
  LPVOID lpvMemoryObject,
  LPCWSTR szRegKey,
  PUCHAR ioPortBase,
  DWORD dwSysIntr 
);

Parameters

• lpvOhcdPddObject
  [in] Pointer to the PDD-specific data for this instance.

• lpvMemoryObject
  [in] Pointer to the memory object created by the HcdMdd_CreateMemoryObject function.

• szRegKey
  [in] Registry key that stores the HCI configuration settings.

• ioPortBase
  [in] Pointer to the HCI controller registers.

• dwSysIntr
  [in] Logical value for a HCI interrupt, SYSINTR_XX.

Return Value

A pointer to a HCI driver object indicates success. NULL indicates failure.

Remarks

The platform dependent driver (PDD) calls this function during initialization to initialize a HCI driver object. As part of this processing, the USB driver, Usbd.dll, is loaded, and the HCI interrupt is hooked into the system. After the host controller interface hardware is placed into OPERATIONAL state and list processing begins, device attach events are serviced, transfers initiated, and so on.

The USB subsystem supports multiple host controllers. The PDD should create a HCI driver object for each physical host controller in the system.

Requirements

See Also

Reference

USB Host Controller Driver MDD Functions
HcdMdd_CreateMemoryObject
HcdMdd_DestroyHcdObject