función WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB (wdfusb.h)

Artículo
02/07/2025

[Se aplica a KMDF y UMDF]

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

Sintaxis

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

Parámetros

[out] Params

Puntero a una estructura de WDF_USB_INTERFACE_SELECT_SETTING_PARAMS asignada por el controlador.

[in] Urb

Puntero a una estructura de URB de.

Valor devuelto

Ninguno

Observaciones

La función WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB 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 WdfUsbInterfaceSelectSettingTypeUrb y establece el miembro Types.Urb.Urb en el valor especificado por puntero Urb.

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

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 URB y, a continuación, se usa la estructura como entrada para WdfUsbInterfaceSelectSetting.

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