USBD_BuildRegisterCompositeDevice-Funktion (usbdlib.h)

Die USBD_BuildRegisterCompositeDevice Routine wird vom Treiber eines USB-Multifunktionsgeräts (Zusammengesetzter Treiber) aufgerufen, um eine REGISTER_COMPOSITE_DEVICE Struktur mit den informationen zu initialisieren, die für die Registrierung des Treibers beim USB-Treiberstapel erforderlich sind.

Die Routine wird von einem Treiber aufgerufen, der den von Microsoft bereitgestellten Verbundtreiber Usbccgp.sysersetzt.

Syntax

VOID USBD_BuildRegisterCompositeDevice(
  [in]  USBD_HANDLE                   USBDHandle,
  [in]  COMPOSITE_DEVICE_CAPABILITIES CapabilityFlags,
  [in]  ULONG                         FunctionCount,
  [out] PREGISTER_COMPOSITE_DEVICE    RegisterCompositeDevice
);

Parameter

[in] USBDHandle

Ein USBD-Handle, das in einem vorherigen Aufruf der USBD_CreateHandle Routine abgerufen wird.

[in] CapabilityFlags

Eine vom Aufrufer zugewiesene COMPOSITE_DEVICE_CAPABILITIES Struktur, die die vom zusammengesetzten Treiber unterstützten Funktionen angibt. Um beispielsweise anzugeben, dass der zusammengesetzte Treiber das Anhalten der Funktion unterstützt, legen Sie den CapabilityFunctionSuspend Member von COMPOSITE_DEVICE_CAPABILITIES auf 1 fest.

[in] FunctionCount

Die Anzahl der physischen Geräteobjekte (PDOs), die vom übergeordneten Treiber erstellt werden sollen. Der wert FunctionCount darf 255 nicht überschreiten.

[out] RegisterCompositeDevice

Ein Zeiger auf eine aufrufergeteilte REGISTER_COMPOSITE_DEVICE Struktur. Nach Abschluss wird die Struktur mit den angegebenen Registrierungsinformationen aufgefüllt. Um den zusammengesetzten Treiber zu registrieren, senden Sie die IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE E/A-Anforderung, und übergeben Sie die ausgefüllte Struktur.

Rückgabewert

Nichts

Anforderungen

Siehe auch

IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE

REGISTER_COMPOSITE_DEVICE