NetTxQueueCreate, fonction (nettxqueue.h)

  • Article

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 que le pilote client a reçu dans EVT_NET_ADAPTER_CREATE_TXQUEUE.

[_In_opt_] TxQueueAttributes

Pointeur vers une structure de WDF_OBJECT_ATTRIBUTES initialisée et alloué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 transmission net.

Valeur retournée

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’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 %
En-tête nettxqueue.h (inclure netadaptercx.h)
IRQL PASSIVE_LEVEL