Compartilhar via


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

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.

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_RXQUEUE função de retorno de chamada, 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.

NetAdapterCx chama EvtNetAdapterCreateRxQueue no final da sequência de ativação.

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