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) |