struktur WDF_USB_DEVICE_SELECT_CONFIG_PARAMS (wdfusb.h)

[Berlaku untuk KMDF dan UMDF]

Struktur WDF_USB_DEVICE_SELECT_CONFIG_PARAMS menentukan parameter konfigurasi perangkat USB.

Sintaks

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;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

Type

Nilai jenis WdfUsbTargetDeviceSelectConfigType yang menentukan jenis konfigurasi yang sedang dipilih atau menunjukkan bahwa konfigurasi saat ini sedang didekonfigurasi.

Types

Types.Descriptor

Types.Descriptor.ConfigurationDescriptor

Jika driver mengatur anggota Jenis ke WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, anggota ini berisi penunjuk yang disediakan driver ke struktur USB_CONFIGURATION_DESCRIPTOR yang menentukan deskriptor konfigurasi. Jika pointer ini ADALAH NULL, kerangka kerja menggunakan konfigurasi pertama perangkat. Untuk informasi selengkapnya tentang memilih konfigurasi USB, lihat bagian Keterangan dari WdfUsbTargetDeviceSelectConfig.

Types.Descriptor.InterfaceDescriptors

Jika driver mengatur Jenis ke WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, anggota ini berisi penunjuk yang disediakan driver ke array struktur USB_INTERFACE_DESCRIPTOR yang mewakili antarmuka yang akan dipilih untuk konfigurasi.

Types.Descriptor.NumInterfaceDescriptors

Jika driver mengatur Jenis ke WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, anggota ini berisi jumlah elemen yang ada dalam array antarmuka yang ditunjuk type.Descriptor.InterfaceDescriptors .

Types.Urb

Types.Urb.Urb

Jika driver mengatur Jenis ke WdfUsbTargetDeviceSelectConfigTypeUrb, anggota ini menentukan struktur URB yang diinisialisasi driver yang digunakan kerangka kerja untuk mengonfigurasi perangkat.

Types.SingleInterface

Types.SingleInterface.NumberConfiguredPipes

Jika driver mengatur Jenis ke WdfUsbTargetDeviceSelectConfigTypeSingleInterface, kerangka kerja menyediakan jumlah pipa yang dikonfigurasi untuk antarmuka.

Types.SingleInterface.ConfiguredUsbInterface

Jika driver mengatur Jenis ke WdfUsbTargetDeviceSelectConfigTypeSingleInterface, kerangka kerja menyediakan handel ke objek antarmuka USB yang mewakili antarmuka yang dikonfigurasi.

Types.MultiInterface

Types.MultiInterface.NumberInterfaces

Jika driver mengatur Jenis ke WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs, anggota ini menentukan jumlah elemen yang ada dalam array Types.MultiInterface.Pairs .

Types.MultiInterface.Pairs

Jika driver mengatur Jenis ke WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs, anggota ini menentukan penunjuk ke array struktur WDF_USB_INTERFACE_SETTING_PAIR yang mengidentifikasi antarmuka untuk dipilih.

Types.MultiInterface.NumberOfConfiguredInterfaces

Jika driver mengatur Jenis ke WdfUsbTargetDeviceSelectConfigTypeInterfacesPairs atau WdfUsbTargetDeviceSelectConfigTypeMultiInterface, kerangka kerja menyediakan jumlah antarmuka yang dikonfigurasi untuk perangkat.

Keterangan

Struktur WDF_USB_DEVICE_SELECT_CONFIG_PARAMS digunakan sebagai input ke WdfUsbTargetDeviceSelectConfig.

Untuk menginisialisasi struktur WDF_USB_DEVICE_SELECT_CONFIG_PARAMS , gunakan salah satu fungsi berikut:

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

Jika driver mengatur jenis anggota ke WdfUsbTargetDeviceSelectConfigTypeInterfacesDescriptor, itu dapat mengubah konfigurasi perangkat USB. Semua nilai lain menggunakan konfigurasi perangkat USB saat ini.

Persyaratan

Persyaratan	Nilai
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfusb.h (termasuk Wdfusb.h)

Lihat juga

USB_CONFIGURATION_DESCRIPTOR

USB_INTERFACE_DESCRIPTOR

WDF_USB_INTERFACE_SETTING_PAIR

WdfUsbTargetDeviceSelectConfigType