EVT_NET_ADAPTER_CREATE_TXQUEUE fonction de rappel (netadapter.h)

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