WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB-Funktion (wdfusb.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

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

Syntax

void WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB(
  [out] PWDF_USB_INTERFACE_SELECT_SETTING_PARAMS Params,
  [in]  PURB                                     Urb
);

Parameter

[out] Params

Ein Zeiger auf eine vom Treiber zugewiesene WDF_USB_INTERFACE_SELECT_SETTING_PARAMS Struktur.

[in] Urb

Ein Zeiger auf eine URB--Struktur.

Rückgabewert

Nichts

Bemerkungen

Die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB-Funktion stellt die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS Struktur null und legt dessen Größe Element auf die Größe der Struktur fest. Außerdem wird der Type Member auf WdfUsbInterfaceSelectSettingTypeUrb festgelegt und der Types.Urb.Urb.Urb Member auf den Wert festgelegt, der von Urb Zeiger angegeben wird.

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 URB-Struktur initialisiert und anschließend die Struktur als Eingabe für WdfUsbInterfaceSelectSettingverwendet.

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS  selectSettingParams;
URB  urb;
NTSTATUS  Status;

//
// Initialize the URB structure here.
//
...

//
// Initialize the WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 
// structure and call WdfUsbInterfaceSelectSetting.
//
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB(
                                      &selectSettingParams,
                                      &urb
                                      );

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