função NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA (netadapter.h)

Artigo
08/07/2023

A função NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA inicializa uma estrutura 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 sistema operacional, bem como o DMA para mapeamento de memória.

Sintaxe

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES  *RxCapabilities,
  [_In_]  NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
  [_In_]  SIZE_T                       MaximumFrameSize,
  [_In_]  SIZE_T                       MaximumNumberOfQueues
);

Parâmetros

[_Out_] RxCapabilities

Um ponteiro para uma estrutura de NET_ADAPTER_RX_CAPABILITIES alocada pelo driver.

[_In_] DmaCapabilities

Um ponteiro para uma estrutura de NET_ADAPTER_DMA_CAPABILITIES alocada e inicializada pelo driver.

[_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 ele gostaria de usar o DMA.

O driver do cliente deve chamar NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA para inicializar sua estrutura de NET_ADAPTER_RX_CAPABILITIES se quiser que o sistema operacional execute a alocação e o anexo do buffer de recebimento e se também quiser usar o DMA em seu caminho de dados de recebimento. Ao chamar essa função, o membro AllocationMode da estrutura de recursos Rx é definido como NetRxFragmentBufferAllocationModeSystem e o membro AttachmentMode é definido como NetRxFragmentBufferAttachmentModeSystem.

Antes de chamar NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA, o driver deve ter alocado uma estrutura de NET_ADAPTER_DMA_CAPABILITIES e inicializado com NET_ADAPTER_DMA_CAPABILITIES_INIT. Essa estrutura de recursos de DMA é atribuída ao membro DmaCapabilities da estrutura NET_ADAPTER_RX_CAPABILITIES .