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 d'NET_EXTENSION_QUERY allouée au pilote et initialisée qui contient des informations sur l’extension de paquet souhaitée.
[_Out_] Extension
Handle d’une structure NET_EXTENSION allouée par le pilote qui reçoit l’extension de paquet.
Valeur de retour
Aucun
Remarques
Les pilotes clients appellent généralement cette fonction à partir de leur EvtNetAdapterCreateTxQueue fonction de rappel après la création de la file d’attente. Pour empêcher 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.29 |
| version minimale de UMDF | 2.33 |
| d’en-tête | nettxqueue.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |