fonction WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE (wdfusb.h)

Article
08/08/2023

[S’applique à KMDF et UMDF]

La fonction WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE initialise une structure WDF_USB_CONTROL_SETUP_PACKET pour un transfert de contrôle USB qui définit ou efface une fonctionnalité d’appareil.

Syntaxe

void WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE(
  [out] PWDF_USB_CONTROL_SETUP_PACKET Packet,
  [in]  WDF_USB_BMREQUEST_RECIPIENT   BmRequestRecipient,
  [in]  USHORT                        FeatureSelector,
  [in]  USHORT                        Index,
  [in]  BOOLEAN                       SetFeature
);

Paramètres

[out] Packet

Pointeur vers une structure WDF_USB_CONTROL_SETUP_PACKET .

[in] BmRequestRecipient

Valeur de type WDF_USB_BMREQUEST_RECIPIENT stockée dans le membre Packet.bm.Request.Recipient de la structure WDF_USB_CONTROL_SETUP_PACKET .

[in] FeatureSelector

Valeur spécifique à une fonctionnalité stockée dans le membre Packet.wValue.Value de la structure WDF_USB_CONTROL_SETUP_PACKET .

[in] Index

Valeur d’index spécifique à une fonctionnalité stockée dans le membre Packet.wIndex.Value de la structure WDF_USB_CONTROL_SETUP_PACKET .

[in] SetFeature

Valeur booléenne qui, si TRUE, indique que la fonctionnalité spécifiée sera définie. Si la valeur est FALSE, la fonctionnalité spécifiée est effacée.

Valeur de retour

None

Remarques

La fonction WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE effectue les opérations suivantes :

Met à zéro la structure WDF_USB_CONTROL_SETUP_PACKET .
Définit le membre Packet.bm.Request.Type sur BmRequestStandard.
Définit le membre Packet.bm.Request.Dir sur BmRequestDeviceToDevice.
Définit le membre Packet.bRequest sur une valeur de requête « set feature » ou « clear feature », en fonction de l’argument SetFeature .
Définit d’autres membres de structure à l’aide des arguments d’entrée de la fonction WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE .

Pour initialiser une structure WDF_USB_CONTROL_SETUP_PACKET , le pilote doit appeler l’une des fonctions suivantes :

WDF_USB_CONTROL_SETUP_PACKET_INIT
WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS
WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE
WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS
WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR

Exemples

L’exemple de code suivant initialise une structure WDF_USB_CONTROL_SETUP_PACKET .

WDF_USB_CONTROL_SETUP_PACKET packet;

WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE(
                                          &packet,
                                          BMREQUEST_TO_DEVICE,
                                          USB_DEVICE_DESCRIPTOR_TYPE,
                                          0,
                                          FALSE
                                          );