funzione WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR (wdfusb.h)

Articolo
02/29/2024

[Si applica a KMDF e UMDF]

La funzione WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR inizializza una struttura WDF_USB_INTERFACE_SELECT_SETTING_PARAMS in modo che un driver possa selezionare un'interfaccia USB specificando un descrittore di interfaccia.

Sintassi

void WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR(
  [out] PWDF_USB_INTERFACE_SELECT_SETTING_PARAMS Params,
  [in]  PUSB_INTERFACE_DESCRIPTOR                Interface
);

Parametri

[out] Params

Puntatore a una struttura di WDF_USB_INTERFACE_SELECT_SETTING_PARAMS allocata dal driver.

[in] Interface

Puntatore a una struttura USB_INTERFACE_DESCRIPTOR .

Valore restituito

nessuno

Osservazioni

La funzione WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR zero la struttura WDF_USB_INTERFACE_SELECT_SETTING_PARAMS e imposta il membro Size sulla dimensione della struttura. Imposta anche il membro Type su WdfUsbInterfaceSelectSettingTypeDescriptor e imposta il membro Types.Descriptor.InterfaceDescriptor sul valore del puntatore Interface.

Per inizializzare una struttura WDF_USB_INTERFACE_SELECT_SETTING_PARAMS , il driver deve chiamare una delle funzioni seguenti:

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB

Esempio

Nell'esempio di codice seguente viene inizializzata una struttura USB_INTERFACE_DESCRIPTOR e quindi viene usata la struttura come input per 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
                                      );