EVT_NET_ADAPTER_CREATE_TXQUEUE fonction de rappel (netadapter.h)

Article
02/07/2025

Implémentation du pilote client de la fonction de rappel d’événement EvtNetAdapterCreateTxQueue qui configure une file d’attente de transmission (Tx).

Syntaxe

EVT_NET_ADAPTER_CREATE_TXQUEUE EvtNetAdapterCreateTxqueue;

NTSTATUS EvtNetAdapterCreateTxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETTXQUEUE_INIT *TxQueueInit
)
{...}

Paramètres

[_In_] Adapter

Objet de carte réseau que le client a créé dans un appel antérieur à NetAdapterCreate.

[_Inout_] TxQueueInit

Pointeur vers une structure NETTXQUEUE_INIT allouée par NetAdapterCx. Pour plus d’informations, consultez la section Remarques.

Valeur de retour

Si l’opération réussit, la fonction de rappel doit retourner STATUS_SUCCESS, ou une autre valeur d’état pour laquelle NT_SUCCESS(status) a la valeur TRUE. Sinon, un code d’erreur NTSTATUS approprié.

Remarques

Pour inscrire une fonction de rappel EVT_NET_ADAPTER_CREATE_TXQUEUE, le pilote client doit appeler NetAdapterCreate.

La structure NETTXQUEUE_INIT est une structure opaque définie et allouée par NetAdapterCx, similaire à WDFDEVICE_INIT.

Dans ce rappel, le pilote client peut appeler NetTxQueueInitGetQueueId pour récupérer l’identificateur de la file d’attente de transmission à configurer. Ensuite, le client appelle NetTxQueueCreate pour allouer une file d’attente. Si NetTxQueueCreate échoue, la fonction de rappel EvtNetAdapterCreateTxQueue doit retourner un code d’erreur.

NetAdapterCx appelle EvtNetAdapterCreateTxQueue à la fin de la séquence de mise sous tension .

Pour obtenir un exemple de code d’implémentation de cette fonction de rappel, 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	netadapter.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Partager via