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 précédent à 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 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