Compartilhar via


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)

Confira também

NET_ADAPTER_TX_CAPABILITIES_INIT

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA