WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR, fonction (wdfusb.h)

Article
08/08/2023

[S’applique à KMDF et UMDF]

La fonction WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR initialise une structure WDF_USB_INTERFACE_SELECT_SETTING_PARAMS afin qu’un pilote puisse sélectionner une interface USB en spécifiant un descripteur d’interface.

Syntaxe

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

Paramètres

[out] Params

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

[in] Interface

Pointeur vers une structure USB_INTERFACE_DESCRIPTOR .

Valeur de retour

None

Remarques

La fonction WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR 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 WdfUsbInterfaceSelectSettingTypeDescriptor et définit le membre Types.Descriptor.InterfaceDescriptor sur la valeur du pointeur d’interface .

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 USB_INTERFACE_DESCRIPTOR , puis utilise la structure comme entrée dans 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
                                      );