Função NetTxQueueCreate (nettxqueue.h)

Cria um objeto de fila de transmissão de rede.

Sintaxe

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

Parâmetros

[_Inout_] NetTxQueueInit

Um ponteiro para a estrutura de NETTXQUEUE_INIT que o driver cliente recebeu em EVT_NET_ADAPTER_CREATE_TXQUEUE.

[_In_opt_] TxQueueAttributes

Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES inicializada alocada pelo chamador. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES. No entanto, se o driver do cliente fornecer esse parâmetro, o campo ParentObject deverá ser NULL.

[_In_] Configuration

Um ponteiro para uma estrutura de NET_PACKET_QUEUE_CONFIG alocada pelo chamador.

[_Out_] PacketQueue

Um ponteiro para um local que recebe um identificador para o novo objeto de fila de transmissão de rede.

Retornar valor

A função retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função pode retornar um código de erro NTSTATUS apropriado.

Comentários

O cliente chama NetTxQueueCreate de dentro de sua EVT_NET_ADAPTER_CREATE_TXQUEUE função de retorno de chamada de evento. Para obter informações sobre como atribuir espaço de contexto ao novo objeto, consulte Espaço de Contexto de Objeto da Estrutura.

O objeto NETPACKETQUEUE é um objeto WDF padrão. A estrutura gerencia sua exclusão, que ocorre quando o objeto NETADAPTER pai é excluído.

Requisitos