WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB, fonction (wdfusb.h)

Article
02/29/2024

[S’applique à KMDF et UMDF]

La fonction WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB initialise une structure de WDF_USB_INTERFACE_SELECT_SETTING_PARAMS afin qu’un pilote puisse sélectionner une interface USB en spécifiant un URB.

Syntaxe

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

Paramètres

[out] Params

Pointeur vers une structure de WDF_USB_INTERFACE_SELECT_SETTING_PARAMS allouée par le pilote.

[in] Urb

Pointeur vers une structure URB .

Valeur de retour

None

Remarques

La fonction WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB met à zéro la structure WDF_USB_INTERFACE_SELECT_SETTING_PARAMS et définit son membre Size sur la taille de la structure. Il définit également le membre Type sur WdfUsbInterfaceSelectSettingTypeUrb et définit le membre Types.Urb.Urb sur la valeur spécifiée par le pointeur Urb .

Pour initialiser une structure WDF_USB_INTERFACE_SELECT_SETTING_PARAMS , votre pilote doit appeler l’une des fonctions suivantes :

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB

Exemples

L’exemple de code suivant initialise une structure URB, puis utilise la structure comme entrée dans 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
                                      );