REGISTER_COMPOSITE_DEVICE-Struktur (usbdlib.h)

Artikel
03/05/2024

Die REGISTER_COMPOSITE_DEVICE-Struktur wird mit der IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE E/A-Steuerungsanforderung verwendet, um einen übergeordneten Treiber eines USB-Multifunktionsgeräts (Universal Serial Bus) (Zusammengesetzter Treiber) beim USB-Treiberstapel zu registrieren.

Um die REGISTER_COMPOSITE_DEVICE-Struktur zu initialisieren, muss der zusammengesetzte Treiber die USBD_BuildRegisterCompositeDevice-Routine aufrufen.

Syntax

typedef struct _REGISTER_COMPOSITE_DEVICE {
  USHORT                        Version;
  USHORT                        Size;
  USBDI_HANDLE                  Reserved;
  COMPOSITE_DEVICE_CAPABILITIES CapabilityFlags;
  ULONG                         FunctionCount;
} REGISTER_COMPOSITE_DEVICE, *PREGISTER_COMPOSITE_DEVICE;

Member

Version

Die Version dieser Struktur. USBD_BuildRegisterCompositeDevice legt dieses Element fest.

Size

Die Größe dieser Struktur. USBD_BuildRegisterCompositeDevice legt dieses Element fest.

Reserved

Reserviert. USBD_BuildRegisterCompositeDevice legt dieses Element fest.

CapabilityFlags

Die Funktionen, die vom zusammengesetzten Treiber unterstützt werden. Um anzugeben, dass funktionsangehalten vom zusammengesetzten Treiber unterstützt wird, initialisieren Sie zuerst die COMPOSITE_DEVICE_CAPABILITIES-Struktur , indem Sie das makro COMPOSITE_DEVICE_CAPABILITIES_INIT aufrufen. Legen Sie dann das CompositeDeviceCapabilityFunctionSuspend-Element von COMPOSITE_DEVICE_CAPABILITIES auf 1 fest. Rufen Sie schließlich USBD_BuildRegisterCompositeDevice auf, und übergeben Sie die initialisierte Struktur im CapabilityFlags-Parameter .

FunctionCount

Die Anzahl der funktionen, die vom zusammengesetzten Gerät unterstützt werden. Der FunctionCount-Wert darf 255 nicht überschreiten.