EVT_NET_ADAPTER_CREATE_TXQUEUE fonction de rappel (netadapter.h)

Article
02/29/2024

Implémentation par le 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 créé par le client lors d’un appel antérieur à NetAdapterCreate.

[_Inout_] TxQueueInit

Pointeur vers une structure de NETTXQUEUE_INIT allouée par NetAdapterCx. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Si l’opération réussit, la fonction de rappel doit retourner STATUS_SUCCESS, ou une autre valeur status pour laquelle NT_SUCCESS(status) est égal à 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 qui est 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 toute 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.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.29
Version UMDF minimale	2,33
En-tête	netadapter.h (inclure netadaptercx.h)
IRQL	PASSIVE_LEVEL

Partager via