NetTxQueueCreate, fonction (nettxqueue.h)

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

Syntaxe

NTSTATUS NetTxQueueCreate(
  [_Inout_]  NETTXQUEUE_INIT         *NetTxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *TxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

Paramètres

[_Inout_] NetTxQueueInit

Pointeur vers la structure NETTXQUEUE_INIT reçue par le pilote client dans EVT_NET_ADAPTER_CREATE_TXQUEUE.

[_In_opt_] TxQueueAttributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTESWDF_OBJECT_ATTRIBUTES allouée par l’appelant initialisé. 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 transmission net.

Valeur de retour

La 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 NetTxQueueCreate à partir de sa fonction de rappel d’événement EVT_NET_ADAPTER_CREATE_TXQUEUE. 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	nettxqueue.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL