NetRxQueueCreate, fonction (netrxqueue.h)

Article
05/23/2024

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

[_In_opt_] RxQueueAttributes

Pointeur vers la structure 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 avoir la valeur 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’attribution d’espace de contexte au nouvel objet, consultez Espace de contexte d’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 %
Version UMDF minimale	2,33
En-tête	netrxqueue.h (inclure netadaptercx.h)
Bibliothèque	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Partager via