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 pelo 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.
Valor de retorno
Nenhum
Observações
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 cliente deve chamar NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED para inicializar sua estrutura de 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 do Rx é definido como NetRxFragmentBufferAllocationModeDriver e o membro AttachmentMode está 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 que o sistema operacional invoque depois que o sistema tiver terminado com o buffer de recebimento.
Requisitos
| Requisito | Valor |
|---|---|
| da 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 |