Partager via


fonction WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR (wdfusb.h)

[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 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS allouée par le pilote.

[in] Interface

Pointeur vers une structure USB_INTERFACE_DESCRIPTOR.

Valeur de retour

Aucun

Remarques

La fonction WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR zéro la structure WDF_USB_INTERFACE_SELECT_SETTING_PARAMS et définit son membre Size à la taille de la structure. Il définit également le membre Type sur WdfUsbInterfaceSelectSettingTypeDescriptor et définit le membre Types.Descriptor.InterfaceDescriptor à la valeur du pointeur interface.

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

Exemples

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

Exigences

Exigence Valeur
plateforme cible Universel
version minimale de KMDF 1.0
version minimale de UMDF 2.0
d’en-tête wdfusb.h (include Wdfusb.h)

Voir aussi

USB_INTERFACE_DESCRIPTOR

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING

WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB