WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR-Funktion (wdfusb.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR-Funktion initialisiert eine WDF_USB_INTERFACE_SELECT_SETTING_PARAMS Struktur, sodass ein Treiber eine USB-Schnittstelle auswählen kann, indem ein Schnittstellendeskriptor angegeben wird.

Syntax

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

Ein Zeiger auf eine vom Treiber zugewiesene WDF_USB_INTERFACE_SELECT_SETTING_PARAMS Struktur.

[in] Interface

Ein Zeiger auf eine USB_INTERFACE_DESCRIPTOR Struktur.

Rückgabewert

Nichts

Bemerkungen

Die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR-Funktion stellt die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS Struktur null und legt dessen Size-Element auf die Größe der Struktur fest. Außerdem wird der Type Member auf WdfUsbInterfaceSelectSettingTypeDescriptor festgelegt und der Types.Descriptor.InterfaceDescriptor Member auf den Wert des Interface Zeigers festgelegt.

Um eine WDF_USB_INTERFACE_SELECT_SETTING_PARAMS-Struktur zu initialisieren, muss Ihr Treiber eine der folgenden Funktionen aufrufen:

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB

Beispiele

Im folgenden Codebeispiel wird eine USB_INTERFACE_DESCRIPTOR Struktur initialisiert und anschließend die Struktur als Eingabe verwendet, um WdfUsbInterfaceSelectSetting zu.

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