função de retorno de chamada EVT_NET_ADAPTER_CREATE_RXQUEUE (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 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 do 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 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
Cabeçalho	netadapter.h (inclua netadaptercx.h)
IRQL	PASSIVE_LEVEL