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

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.

Retornar valor

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

Comentários

Para registrar um EVT_NET_ADAPTER_CREATE_TXQUEUE função de retorno de chamada, 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.

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

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
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