NetRxQueueCreate, fonction (netrxqueue.h)

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

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 reçue par le pilote client dans sa fonction de rappel EVT_NET_ADAPTER_CREATE_RXQUEUE.

[_In_opt_] RxQueueAttributes

Pointeur vers la structure de WDF_OBJECT_ATTRIBUTES allouée à l’appelant et initialisée. 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 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 de retour

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 d’objet Framework.

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

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.27
version minimale de UMDF	2.33
d’en-tête	netrxqueue.h (include netadaptercx.h)
bibliothèque	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL