WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB-Funktion (wdfusb.h)

Artikel
02/29/2024

[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 er eine URB angibt.

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

Keine

Bemerkungen

Die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB-Funktion stellt die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS-Struktur auf Null und legt den Size-Member auf die Größe der Struktur fest. Außerdem wird das Type-Element auf WdfUsbInterfaceSelectSettingTypeUrb festgelegt und das Types.Urb.Urb-Element auf den Wert festgelegt, der durch den 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 dann die -Struktur als Eingabe für WdfUsbInterfaceSelectSetting verwendet.

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