WDF_USB_INTERFACE_SELECT_SETTING_PARAMS-Struktur (wdfusb.h)

Artikel
03/01/2024

[Gilt für KMDF und UMDF]

Die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS-Struktur enthält Auswahlinformationen für eine USB-Schnittstelle.

Syntax

typedef struct _WDF_USB_INTERFACE_SELECT_SETTING_PARAMS {
  ULONG                               Size;
  WdfUsbTargetDeviceSelectSettingType Type;
  union {
    struct {
      PUSB_INTERFACE_DESCRIPTOR InterfaceDescriptor;
    } Descriptor;
    struct {
      UCHAR SettingIndex;
    } Interface;
    struct {
      PURB Urb;
    } Urb;
  } Types;
} WDF_USB_INTERFACE_SELECT_SETTING_PARAMS, *PWDF_USB_INTERFACE_SELECT_SETTING_PARAMS;

Member

Size

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

Type

Ein WdfUsbTargetDeviceSelectSettingType-typisierter Wert, der eine Technik zum Angeben einer Geräteschnittstelle identifiziert.

Types

Types.Descriptor

Types.Descriptor.InterfaceDescriptor

Wenn das Type-ElementWdfUsbInterfaceSelectSettingTypeDescriptor ist, enthält dieses Element einen Zeiger auf eine USB_INTERFACE_DESCRIPTOR Struktur, die eine Geräteschnittstelle identifiziert.

Types.Interface

Types.Interface.SettingIndex

Wenn das Type-ElementWdfUsbInterfaceSelectSettingTypeSetting ist, enthält dieses Element einen Indexwert, der eine alternative Einstellung für die Schnittstelle identifiziert. (Die Schnittstelle wird durch ein Schnittstellenobjekthandle identifiziert, das der Treiber an WdfUsbInterfaceSelectSetting übergibt.)

Types.Urb

Types.Urb.Urb

Wenn das Type-ElementWdfUsbInterfaceSelectSettingTypeUrb ist, enthält dieses Element einen Zeiger auf eine URB-Struktur , die eine Geräteschnittstelle beschreibt. Der Function-Member der URB-Struktur muss URB_FUNCTION_SELECT_INTERFACE sein, und andere Member müssen entsprechend der Schnittstelle initialisiert werden.