função NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED (netadapter.h)

A função NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED inicializa uma estrutura de NET_ADAPTER_RX_CAPABILITIES para um adaptador de rede que gostaria de especificar a alocação e o anexo do buffer de recebimento gerenciado pelo driver.

Sintaxe

void NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES      *RxCapabilities,
  [_In_]  PFN_NET_ADAPTER_RETURN_RX_BUFFER EvtAdapterReturnRxBuffer,
  [_In_]  SIZE_T                           MaximumFrameSize,
  [_In_]  SIZE_T                           MaximumNumberOfQueues
);

Parâmetros

[_Out_] RxCapabilities

Um ponteiro para uma estrutura de NET_ADAPTER_RX_CAPABILITIES alocada por driver.

[_In_] EvtAdapterReturnRxBuffer

Um ponteiro para a função de retorno de chamada EVT_NET_ADAPTER_RETURN_RX_BUFFER do driver cliente. Para obter mais informações, consulte a seção Comentários.

[_In_] MaximumFrameSize

O tamanho máximo do quadro, em bytes, que o adaptador pode receber.

[_In_] MaximumNumberOfQueues

O número máximo de filas de recebimento compatíveis com o adaptador.

Retornar valor

Nenhum

Comentários

Essa função é uma das três funções possíveis a serem chamadas para inicializar uma estrutura de NET_ADAPTER_RX_CAPABILITIES . Qual deles o driver cliente deve chamar depende de como ele gostaria de alocar buffers de recebimento e se gostaria de usar o AMD.

O driver cliente deve chamar NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED para inicializar sua estrutura NET_ADAPTER_RX_CAPABILITIES se quiser executar a alocação e o anexo do buffer de recebimento manual. Ao chamar essa função, o membro AllocationMode da estrutura de recursos Rx é definido como NetRxFragmentBufferAllocationModeDriver e o membro AttachmentMode é definido como NetRxFragmentBufferAttachmentModeDriver. Nesse caso, ele também deve fornecer um ponteiro para sua função de retorno de chamada EVT_NET_ADAPTER_RETURN_RX_BUFFER na estrutura para o sistema operacional invocar depois que o sistema terminar de receber o buffer.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1,25
Versão mínima do UMDF 2.33
Cabeçalho netadapter.h (inclua netadaptercx.h)
IRQL PASSIVE_LEVEL

Confira também

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA