EVT_NET_ADAPTER_CREATE_RXQUEUE 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 EvtNetAdapterCreateRxQueue que configura uma fila de recebimento (Rx).

Sintaxe

EVT_NET_ADAPTER_CREATE_RXQUEUE EvtNetAdapterCreateRxqueue;

NTSTATUS EvtNetAdapterCreateRxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETRXQUEUE_INIT *RxQueueInit
)
{...}

Parâmetros

[_In_] Adapter

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

[_Inout_] RxQueueInit

Um ponteiro para uma estrutura de NETRXQUEUE_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_RXQUEUE, o driver cliente deve chamar NetAdapterCreate.

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

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

O NetAdapterCx chama EvtNetAdapterCreateRxQueue 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