estrutura NET_ADAPTER_TX_CAPABILITIES (netadapter.h)
A estrutura NET_ADAPTER_TX_CAPABILITIES descreve os recursos de transmissão de um adaptador de rede.
Sintaxe
typedef struct _NET_ADAPTER_TX_CAPABILITIES {
ULONG Size;
NET_MEMORY_MAPPING_REQUIREMENT MappingRequirement;
SIZE_T PayloadBackfill;
SIZE_T MaximumNumberOfFragments;
SIZE_T FragmentBufferAlignment;
UINT32 FragmentRingNumberOfElementsHint;
SIZE_T MaximumNumberOfQueues;
NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities;
} NET_ADAPTER_TX_CAPABILITIES;
Membros
Size
O tamanho dessa estrutura, em bytes.
MappingRequirement
Um valor NET_MEMORY_MAPPING_REQUIREMENT que especifica como o sistema operacional deve mapear buffers de dados de transmissão.
Os drivers UMDF devem definir MappingRequirement como NetMemoryMappingRequirementNone.
PayloadBackfill
A quantidade de espaço, em bytes, reservada para o driver cliente antes do início da carga de cada NET_PACKET.
MaximumNumberOfFragments
O número máximo de fragmentos por pacote que o adaptador pode manipular ou ((SIZE_T) - 1) se não há limite.
FragmentBufferAlignment
O alinhamento mínimo para fragmentos de pacote. Esse membro deve ser uma potência de 2.
FragmentRingNumberOfElementsHint
Uma dica que indica quantos elementos o adaptador deseja para cada buffer de anel NET_FRAGMENT da fila de transmissão. Esse membro deve ser uma potência de 2.
MaximumNumberOfQueues
O número máximo de filas de transmissão compatíveis com o adaptador.
DmaCapabilities
Um ponteiro para uma estrutura de NET_DMA_CAPABILITIES alocada e inicializada pelo driver que descreve os recursos de DMA do adaptador no caminho de transmissão. Esse membro será ignorado por NetAdapterCx se MappingRequirement não estiver definido como NetMemoryMappingRequirementDmaMapped.
UMDF NetAdapterCX não dá suporte a DmaCapabilities. Os drivers UMDF devem definir esse membro como NULL.
Comentários
Chame uma das funções NET_ADAPTER_TX_CAPABILITIES_INIT_XXX para inicializar essa estrutura. Para obter mais informações sobre cada função de inicialização, consulte os links na seção Consulte Também.
Uma estrutura de NET_ADAPTER_TX_CAPABILITIES inicializada é passada como um parâmetro para NetAdapterSetDatapathCapabilities.
Requisitos
| Requisito | Valor |
|---|---|
| Versão mínima do KMDF | 1.27 |
| Versão mínima do UMDF | 2.33 |
| Cabeçalho | netadapter.h (inclua netadaptercx.h) |