WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR函式 (wdfusb.h)

發行項
02/27/2024

[適用於 KMDF 和 UMDF]

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR函式會初始化WDF_USB_INTERFACE_SELECT_SETTING_PARAMS結構，讓驅動程式可以藉由指定介面描述元來選取 USB 介面。

語法

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

參數

[out] Params

驅動程式配置的 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 結構的指標。

[in] Interface

USB_INTERFACE_DESCRIPTOR 結構的指標。

傳回值

無

備註

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR函式會零WDF_USB_INTERFACE_SELECT_SETTING_PARAMS結構，並將其 Size 成員設定為結構的大小。它也會將 Type 成員設定為 WdfUsbInterfaceSelectSettingTypeDescriptor ，並將 Types.Descriptor.InterfaceDescriptor 成員設定為 Interface 指標的值。

若要初始化 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 結構，驅動程式必須呼叫下列其中一個函式：

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB

範例

下列程式代碼範例會初始化 USB_INTERFACE_DESCRIPTOR 結構，然後使用結構做為 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
                                      );