EVT_NET_ADAPTER_CREATE_RXQUEUE fonction de rappel (netadapter.h)

Article
05/23/2024

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

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