estrutura NET_ADAPTER_DMA_CAPABILITIES (netadapter.h)

  • Artigo

A estrutura NET_ADAPTER_DMA_CAPABILITIES descreve os recursos de DMA de um adaptador de rede.

Sintaxe

typedef struct _NET_ADAPTER_DMA_CAPABILITIES {
  ULONG            Size;
  WDFDMAENABLER    DmaEnabler;
  PHYSICAL_ADDRESS MaximumPhysicalAddress;
  WDF_TRI_STATE    CacheEnabled;
  NODE_REQUIREMENT PreferredNode;
} NET_ADAPTER_DMA_CAPABILITIES;

Membros

Size

O tamanho dessa estrutura, em bytes.

DmaEnabler

O objeto habilitador de DMA usado pelo driver cliente para mapear e alocar memória.

Importante

Ao configurar esse objeto com a estrutura WDF_DMA_ENABLER_CONFIG , os drivers de cliente devem definir o membro WdmDmaVersionOverride como 3 para especificar a versão 3 do DMA.

MaximumPhysicalAddress

O endereço físico máximo a ser usado ao alocar buffers de memória. Defina esse membro como 0 para indicar que não há endereço máximo.

CacheEnabled

Um valor WDF_TRI_STATE que define se a memória alocada deve ter o cache habilitado ou não. Se esse membro estiver definido como WdfDefault, o cache será habilitado somente se o dispositivo for coerente com o cache.

PreferredNode

O nó NUMA preferencial a ser usado ao alocar memória. Se esse membro estiver definido como MM_ANY_NODE_OK, NetAdapterCx determinará automaticamente o melhor nó a ser usado.

Comentários

Chame NET_ADAPTER_DMA_CAPABILITIES_INIT para inicializar essa estrutura.

Essa estrutura pode ser usada no caminho de recebimento, como membro da estrutura NET_ADAPTER_RX_CAPABILITIES ou no caminho de transmissão como membro da estrutura NET_ADAPTER_TX_CAPABILITIES .

Requisitos

Requisito Valor
Versão mínima do KMDF 1.27
Cabeçalho netadapter.h (inclua netadaptercx.h)

Confira também

NET_ADAPTER_DMA_CAPABILITIES_INIT

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_TX_CAPABILITIES