EVT_NET_ADAPTER_CREATE_TXQUEUE função de retorno de chamada (netadapter.h)

Artigo
02/07/2025

A implementação do driver cliente da função de retorno de chamada de evento EvtNetAdapterCreateTxQueue que configura uma fila de transmissão (Tx).

Sintaxe

EVT_NET_ADAPTER_CREATE_TXQUEUE EvtNetAdapterCreateTxqueue;

NTSTATUS EvtNetAdapterCreateTxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETTXQUEUE_INIT *TxQueueInit
)
{...}

Parâmetros

[_In_] Adapter

O objeto do adaptador de rede que o cliente criou em uma chamada anterior para NetAdapterCreate.

[_Inout_] TxQueueInit

Um ponteiro para uma estrutura de NETTXQUEUE_INIT alocada por NetAdapterCx. Para obter mais informações, consulte a seção Comentários.

Valor de retorno

Se a operação for bem-sucedida, a função de retorno de chamada deverá retornar STATUS_SUCCESS ou outro valor de status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, um código de erro NTSTATUS apropriado.

Observações

Para registrar uma função de retorno de chamada EVT_NET_ADAPTER_CREATE_TXQUEUE, o driver cliente deve chamar NetAdapterCreate.

A estrutura NETTXQUEUE_INIT é uma estrutura opaca definida e alocada por NetAdapterCx, semelhante a WDFDEVICE_INIT.

Nesse retorno de chamada, o driver cliente pode chamar NetTxQueueInitGetQueueId para recuperar o identificador da fila de transmissão a ser configurada. Em seguida, o cliente chama NetTxQueueCreate para alocar uma fila. Se NetTxQueueCreate falhar, a função de retorno de chamada EvtNetAdapterCreateTxQueue deverá retornar um código de erro.

O NetAdapterCx chama EvtNetAdapterCreateTxQueue no final da sequência de .

Para obter um exemplo de código de implementação dessa função de retorno de chamada, consulte Transmitir e receber filas.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.29
versão mínima do UMDF	2.33
cabeçalho	netadapter.h (inclua netadaptercx.h)
IRQL	PASSIVE_LEVEL

Compartilhar via