NetTxQueueGetExtension, fonction (nettxqueue.h)

La fonction NetTxQueueGetExtension récupère une extension de paquets pour tous les paquets d’une file d’attente de transmission (Tx).

Syntaxe

void NetTxQueueGetExtension(
  [_In_]  NETPACKETQUEUE            PacketQueue,
  [_In_]  const NET_EXTENSION_QUERY *Query,
  [_Out_] NET_EXTENSION             *Extension
);

Paramètres

[_In_] PacketQueue

Objet file d’attente de transmission.

[_In_] Query

Pointeur vers une structure de NET_EXTENSION_QUERY allouée par le pilote et initialisée qui contient des informations sur l’extension de paquet souhaitée.

[_Out_] Extension

Handle pour une structure de NET_EXTENSION allouée par le pilote qui reçoit l’extension de paquet.

Valeur de retour

None

Remarques

Les pilotes clients appellent généralement cette fonction à partir de leur fonction de rappel EvtNetAdapterCreateTxQueue après la création de la file d’attente. Pour éviter les requêtes d’extension fréquentes, stockez l’extension retournée par cette fonction dans votre espace de contexte de file d’attente.

Pour obtenir un exemple de code de création d’une file d’attente de transmission, consultez Transmettre et recevoir des files d’attente.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.29
En-tête nettxqueue.h (inclure netadaptercx.h)
IRQL PASSIVE_LEVEL

Voir aussi

Descripteurs de paquets et extensions