fungsi WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR (wdfusb.h)

Artikel
02/29/2024

[Berlaku untuk KMDF dan UMDF]

Fungsi WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR menginisialisasi struktur WDF_USB_INTERFACE_SELECT_SETTING_PARAMS sehingga driver dapat memilih antarmuka USB dengan menentukan deskriptor antarmuka.

Sintaks

void WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR(
  [out] PWDF_USB_INTERFACE_SELECT_SETTING_PARAMS Params,
  [in]  PUSB_INTERFACE_DESCRIPTOR                Interface
);

Parameter

[out] Params

Penunjuk ke struktur WDF_USB_INTERFACE_SELECT_SETTING_PARAMS yang dialokasikan driver.

[in] Interface

Penunjuk ke struktur USB_INTERFACE_DESCRIPTOR .

Nilai kembali

Tidak ada

Keterangan

Fungsi WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR nol struktur WDF_USB_INTERFACE_SELECT_SETTING_PARAMS dan mengatur anggota Ukurannya ke ukuran struktur. Ini juga mengatur anggota Jenis ke WdfUsbInterfaceSelectSettingTypeDescriptor dan mengatur anggota Types.Descriptor.InterfaceDescriptor ke nilai penunjuk Antarmuka .

Untuk menginisialisasi struktur WDF_USB_INTERFACE_SELECT_SETTING_PARAMS , driver Anda harus memanggil salah satu fungsi berikut:

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB

Contoh

Contoh kode berikut menginisialisasi struktur USB_INTERFACE_DESCRIPTOR lalu menggunakan struktur sebagai input ke WdfUsbInterfaceSelectSetting.

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS  selectSettingParams;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;
NTSTATUS  Status;

//
// Initialize the USB_INTERFACE_DESCRIPTOR structure here.
//
...

//
// Initialize the WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 
// structure and call WdfUsbInterfaceSelectSetting.
//
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR(
                                      &selectSettingParams,
                                      &interfaceDescriptor
                                      );

Status = WdfUsbInterfaceSelectSetting(
                                      UsbInterface,
                                      WDF_NO_OBJECT_ATTRIBUTES,
                                      &selectSettingParams
                                      );