USBD_BuildRegisterCompositeDevice-Funktion (usbdlib.h)

  • Artikel

Die USBD_BuildRegisterCompositeDevice Routine wird vom Treiber eines USB-Mehrfunktionsgerä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 zusammengesetzten Treiber ersetzt, Usbccgp.sys.

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 funktionen angibt, die vom zusammengesetzten Treiber unterstützt werden. Legen Sie für instance das CapabilityFunctionSuspend-Element von COMPOSITE_DEVICE_CAPABILITIES auf 1 fest, um anzugeben, dass der zusammengesetzte Treiber das Anhalten der Funktion unterstützt.

[in] FunctionCount

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

[out] RegisterCompositeDevice

Ein Zeiger auf eine aufruferseitig zugeordnete 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 aufgefüllte Struktur.

Rückgabewert

Keine

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Erfordert WDK für Windows 8. Zielt auf Windows Vista und höhere Versionen des Windows-Betriebssystems ab.
Zielplattform Desktop
Kopfzeile usbdlib.h
Bibliothek Usbdex.lib
IRQL < = DISPATCH_LEVEL

Weitere Informationen

IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE

REGISTER_COMPOSITE_DEVICE