USBD_BuildRegisterCompositeDevice-Funktion (usbdlib.h)
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 |