WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR-Funktion (wdfusb.h)

Artikel
02/27/2024

[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 er einen Schnittstellendeskriptor angibt.

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

Keine

Bemerkungen

Die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR-Funktion nullt die WDF_USB_INTERFACE_SELECT_SETTING_PARAMS-Struktur und legt den Size-Member auf die Größe der Struktur fest. Außerdem wird das Type-Element auf WdfUsbInterfaceSelectSettingTypeDescriptor festgelegt und das Types.Descriptor.InterfaceDescriptor-Element auf den Wert des Schnittstellenzeigers 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 dann die -Struktur als Eingabe für WdfUsbInterfaceSelectSetting verwendet.

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