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 |