EVT_NET_ADAPTER_CREATE_RXQUEUE fonction de rappel (netadapter.h)

Implémentation par le pilote client de la fonction de rappel d’événement EvtNetAdapterCreateRxQueue qui configure une file d’attente de réception (Rx).

Syntaxe

EVT_NET_ADAPTER_CREATE_RXQUEUE EvtNetAdapterCreateRxqueue;

NTSTATUS EvtNetAdapterCreateRxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETRXQUEUE_INIT *RxQueueInit
)
{...}

Paramètres

[_In_] Adapter

Objet de carte réseau créé par le client lors d’un appel antérieur à NetAdapterCreate.

[_Inout_] RxQueueInit

Pointeur vers une structure de NETRXQUEUE_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_RXQUEUE, le pilote client doit appeler NetAdapterCreate.

La structure NETRXQUEUE_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 NetRxQueueInitGetQueueId pour récupérer l’identificateur de la file d’attente de réception à configurer. Ensuite, le client appelle NetRxQueueCreate pour allouer une file d’attente. Si NetRxQueueCreate échoue, la fonction de rappel EvtNetAdapterCreateRxQueue doit retourner un code d’erreur.

NetAdapterCx appelle EvtNetAdapterCreateRxQueue à 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
En-tête netadapter.h (inclure netadaptercx.h)
IRQL PASSIVE_LEVEL