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 :
- WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR
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
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS