NetRxQueueCreate, fonction (netrxqueue.h)

  • Article

Crée un objet de file d’attente de réception nette.

Syntaxe

NTSTATUS NetRxQueueCreate(
  [_Inout_]  NETRXQUEUE_INIT         *NetRxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *RxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

Paramètres

[_Inout_] NetRxQueueInit

Pointeur vers la structure NETRXQUEUE_INIT que le pilote client a reçue dans sa fonction de rappel EVT_NET_ADAPTER_CREATE_RXQUEUE .

[_In_opt_] RxQueueAttributes

Pointeur vers la structure de WDF_OBJECT_ATTRIBUTES allouée et initialisée par l’appelant. Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES. Toutefois, si le pilote client fournit ce paramètre, le champ ParentObject doit être NULL.

[_In_] Configuration

Pointeur vers une structure de NET_PACKET_QUEUE_CONFIG allouée par l’appelant.

[_Out_] PacketQueue

Pointeur vers un emplacement qui reçoit un handle vers le nouvel objet de file d’attente de réception net.

Valeur retournée

Cette fonction retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette fonction peut retourner un code d’erreur NTSTATUS approprié.

Remarques

Le client appelle NetRxQueueCreate à partir de sa fonction de rappel d’événement EVT_NET_ADAPTER_CREATE_RXQUEUE . Pour plus d’informations sur l’affectation d’espace de contexte au nouvel objet, consultez Espace de contexte de l’objet framework.

L’objet NETPACKETQUEUE est un objet WDF standard. L’infrastructure gère sa suppression, qui se produit lorsque l’objet NETADAPTER parent est supprimé.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1,27 %
En-tête netrxqueue.h (inclure netadaptercx.h)
Bibliothèque NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL