Função NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED (netadapter.h)
A função NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_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 sistema operacional, mas não o uso do mapeamento de memória DMA.
Sintaxe
void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED(
[_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
[_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_] 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_SYSTEM_MANAGED 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, mas não requer mapeamento de memória DMA. Ao chamar essa função, o membro AllocationMode da estrutura de recursos Rx é definido como NetRxFragmentBufferAllocationModeSystem e o membro AttachmentMode é definido como NetRxFragmentBufferAttachmentModeSystem. Como o driver não especifica recursos de DMA nesse caso, essa função também define o membro MappingRequirement como NetMemoryMappingRequirementNone.
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) |