EVT_NET_ADAPTER_CREATE_RXQUEUE fonction de rappel (netadapter.h)

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