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;
Angehörige
Size
Die Größe dieser Struktur in Byte.
Type
Ein WdfUsbTargetDeviceSelectConfigType-typed-Wert, der entweder den Typ der ausgewählten Konfiguration angibt oder angibt, dass die aktuelle Konfiguration deconiert wird.
Types
Types.Descriptor
Types.Descriptor.ConfigurationDescriptor
Wenn der Treiber den Type Member auf WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptorfestlegt, 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 WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptorfestgelegt wird, 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 WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptorfestlegt, enthält dieses Element die Anzahl der Elemente, die sich im Schnittstellenarray befinden, auf das Types.Descriptor.InterfaceDescriptors verweist.
Types.Urb
Types.Urb.Urb
Wenn der Treiber Typ- auf WdfUsbTargetDeviceSelectConfigTypeUrbfestlegt, gibt dieses Element eine treiberinitialisierte URB- Struktur an, die das Framework zum Konfigurieren des Geräts verwendet.
Types.SingleInterface
Types.SingleInterface.NumberConfiguredPipes
Wenn der Treiber Type auf WdfUsbTargetDeviceSelectConfigTypeSingleInterfacefestlegt, stellt das Framework die Anzahl der Rohre bereit, die für die Schnittstelle konfiguriert sind.
Types.SingleInterface.ConfiguredUsbInterface
Wenn der Treiber Type auf WdfUsbTargetDeviceSelectConfigTypeSingleInterfacefestlegt, 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 WdfUsbTargetDeviceSelectConfigTypeInterfacesPairsfestlegt, gibt dieses Element die Anzahl der Elemente an, die sich im Types.MultiInterface.Pairs Array befinden.
Types.MultiInterface.Pairs
Wenn der Treiber Type auf WdfUsbTargetDeviceSelectConfigTypeInterfacesPairsfestlegt, gibt dieses Element 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 WdfUsbTargetDeviceSelectConfigTypeMultiInterfacefestlegt, stellt das Framework die Anzahl der Schnittstellen bereit, die für das Gerät konfiguriert sind.
Bemerkungen
Die WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur wird als Eingabe für WdfUsbTargetDeviceSelectConfigverwendet.
Verwenden Sie zum Initialisieren einer WDF_USB_DEVICE_SELECT_CONFIG_PARAMS-Struktur eine der folgenden Funktionen:
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 den Type Member auf WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptorfestlegt, kann er die USB-Gerätekonfiguration ändern. Alle anderen Werte verwenden die aktuelle KONFIGURATION des USB-Geräts.
Anforderungen
| Anforderung | Wert |
|---|---|
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfusb.h (include Wdfusb.h) |