共用方式為

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR函式 （wdfusb.h）

  • 發行項

[適用於 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 結構，您的驅動程式必須呼叫下列其中一個函式：

例子

下列程式代碼範例會初始化 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
                                      );

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
標頭 wdfusb.h （包括 Wdfusb.h）

另請參閱

USB_INTERFACE_DESCRIPTOR

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB