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