Fonction NetTxQueueGetExtension (nettxqueue.h)

La fonction NetTxQueueGetExtension récupère une extension de paquet 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 et initialisée par un pilote qui contient des informations sur l’extension de paquet souhaitée.

[_Out_] Extension

Handle à une structure de NET_EXTENSION allouée par un 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
Version UMDF minimale	2,33
En-tête	nettxqueue.h (inclure netadaptercx.h)
IRQL	PASSIVE_LEVEL

Voir aussi

Descripteurs et extensions de paquets