función WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR (wdfusb.h)

Artículo
03/05/2024

[Se aplica a KMDF y UMDF]

La función WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR inicializa una estructura de WDF_USB_INTERFACE_SELECT_SETTING_PARAMS para que un controlador pueda seleccionar una interfaz USB especificando un descriptor de interfaz.

Sintaxis

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

Parámetros

[out] Params

Puntero a una estructura de WDF_USB_INTERFACE_SELECT_SETTING_PARAMS asignada por el controlador.

[in] Interface

Puntero a una estructura de USB_INTERFACE_DESCRIPTOR .

Valor devuelto

None

Observaciones

La función WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR cero la estructura WDF_USB_INTERFACE_SELECT_SETTING_PARAMS y establece su miembro Size en el tamaño de la estructura. También establece el miembro Type en WdfUsbInterfaceSelectSettingTypeDescriptor y establece el miembro Types.Descriptor.InterfaceDescriptor en el valor del puntero Interface .

Para inicializar una estructura de WDF_USB_INTERFACE_SELECT_SETTING_PARAMS , el controlador debe llamar a una de las siguientes funciones:

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB

Ejemplos

En el ejemplo de código siguiente se inicializa una estructura de USB_INTERFACE_DESCRIPTOR y, a continuación, se usa la estructura como entrada para 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
                                      );