EVT_NET_ADAPTER_CREATE_RXQUEUE fonction de rappel (netadapter.h)

Article
02/07/2025

Implémentation du pilote client de la fonction de rappel d’événements 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 que le client a créé dans un appel antérieur à NetAdapterCreate.

[_Inout_] RxQueueInit

Pointeur vers une structure NETRXQUEUE_INIT allouée à 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_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 fin de la séquence d’alimentation .

Pour obtenir un exemple de code d’implémentation de cette fonction de rappel, consultez Transmettre et recevoir des files d’attente.

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.29
version minimale de UMDF	2.33
d’en-tête	netadapter.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Partager via