WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur (wdfusb.h)

[Gilt für KMDF und UMDF]

Die WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur gibt USB-Gerätekonfigurationsparameter an.

Syntax

typedef struct _WDF_USB_DEVICE_SELECT_CONFIG_PARAMS {
  ULONG                              Size;
  WdfUsbTargetDeviceSelectConfigType Type;
  union {
    struct {
      PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor;
      PUSB_INTERFACE_DESCRIPTOR     *InterfaceDescriptors;
      ULONG                         NumInterfaceDescriptors;
    } Descriptor;
    struct {
      PURB Urb;
    } Urb;
    struct {
      UCHAR           NumberConfiguredPipes;
      WDFUSBINTERFACE ConfiguredUsbInterface;
    } SingleInterface;
    struct {
      UCHAR                           NumberInterfaces;
      PWDF_USB_INTERFACE_SETTING_PAIR Pairs;
      UCHAR                           NumberOfConfiguredInterfaces;
    } MultiInterface;
  } Types;
} WDF_USB_DEVICE_SELECT_CONFIG_PARAMS, *PWDF_USB_DEVICE_SELECT_CONFIG_PARAMS;

Member

Size

Die Größe (in Bytes) dieser Struktur.

Type

Ein WdfUsbTargetDeviceSelectConfigType-typisierter Wert, der entweder den Typ der ausgewählten Konfiguration angibt oder angibt, dass die aktuelle Konfiguration deconfiguriert wird.

Types

Types.Descriptor

Types.Descriptor.ConfigurationDescriptor

Wenn der Treiber das Type-Element auf WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor festlegt, enthält dieses Element einen vom Treiber bereitgestellten Zeiger auf eine USB_CONFIGURATION_DESCRIPTOR-Struktur , die einen Konfigurationsdeskriptor angibt. Wenn dieser Zeiger NULL ist, verwendet das Framework die erste Konfiguration des Geräts. Weitere Informationen zum Auswählen einer USB-Konfiguration finden Sie im Abschnitt Hinweise von WdfUsbTargetDeviceSelectConfig.

Types.Descriptor.InterfaceDescriptors

Wenn der Treiber Type auf WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor festlegt, enthält dieses Element einen vom Treiber bereitgestellten Zeiger auf ein Array von USB_INTERFACE_DESCRIPTOR Strukturen, die die schnittstellen darstellen, die für die Konfiguration ausgewählt werden sollen.

Types.Descriptor.NumInterfaceDescriptors

Wenn der Treiber Type auf WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor festlegt, enthält dieser Member die Anzahl der Elemente im Schnittstellenarray, auf das Types.Descriptor.InterfaceDescriptors verweist.

Types.Urb

Types.Urb.Urb

Wenn der Treiber Type auf WdfUsbTargetDeviceSelectConfigTypeUrb festlegt, gibt dieser Member eine vom Treiber initialisierte URB-Struktur an, die das Framework zum Konfigurieren des Geräts verwendet.

Types.SingleInterface

Types.SingleInterface.NumberConfiguredPipes

Wenn der Treiber Type auf WdfUsbTargetDeviceSelectConfigTypeSingleInterface festlegt, stellt das Framework die Anzahl von Pipes bereit, die für die Schnittstelle konfiguriert sind.

Types.SingleInterface.ConfiguredUsbInterface

Wenn der Treiber Type auf WdfUsbTargetDeviceSelectConfigTypeSingleInterface festlegt, stellt das Framework ein Handle für ein USB-Schnittstellenobjekt bereit, das die konfigurierte Schnittstelle darstellt.

Types.MultiInterface

Types.MultiInterface.NumberInterfaces

Wenn der Treiber Type auf WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs festlegt, gibt dieser Member die Anzahl der Elemente an, die sich im Types.MultiInterface.Pairs-Array befinden.

Types.MultiInterface.Pairs

Wenn der Treiber Type auf WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs festlegt, gibt dieser Member einen Zeiger auf ein Array von WDF_USB_INTERFACE_SETTING_PAIR Strukturen an, die die auszuwählenden Schnittstellen identifizieren.

Types.MultiInterface.NumberOfConfiguredInterfaces

Wenn der Treiber Type auf WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs oder WdfUsbTargetDeviceSelectConfigTypeMultiInterface festlegt, stellt das Framework die Anzahl von Schnittstellen bereit, die für das Gerät konfiguriert sind.

Hinweise

Die WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur wird als Eingabe für WdfUsbTargetDeviceSelectConfig verwendet.

Verwenden Sie eine der folgenden Funktionen, um eine WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur zu initialisieren:

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_MULTIPLE_INTERFACES

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS

WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_URB

Wenn der Treiber das Type-Element auf WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor festlegt, kann er die USB-Gerätekonfiguration ändern. Alle anderen Werte verwenden die aktuelle USB-Gerätekonfiguration.

Anforderungen

Anforderung	Wert
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfusb.h (wdfusb.h einschließen)

Weitere Informationen

USB_CONFIGURATION_DESCRIPTOR

USB_INTERFACE_DESCRIPTOR

WDF_USB_INTERFACE_SETTING_PAIR

WdfUsbTargetDeviceSelectConfigType