Partilhar via


NET_ADAPTER_TX_CAPABILITIES estrutura (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 para NetMemoryMappingRequirementNone.

PayloadBackfill

A quantidade de espaço, em bytes, reservada para o driver cliente antes do início de cada 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 houver limite.

FragmentBufferAlignment

O alinhamento mínimo para fragmentos de pacote. Esse membro deve ser um poder 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 um poder de 2.

MaximumNumberOfQueues

O número máximo de filas de transmissão que o adaptador dá suporte.

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.

O UMDF NetAdapterCX não dá suporte a DmaCapabilities. Os drivers UMDF devem definir esse membro como NULL.

Observações

Chame uma das funçõesXXX NET_ADAPTER_TX_CAPABILITIES_INIT_ 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)

Consulte também

NET_ADAPTER_TX_CAPABILITIES_INIT

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA