NET_ADAPTER_DMA_CAPABILITIES-Struktur (netadapter.h)

Die NET_ADAPTER_DMA_CAPABILITIES-Struktur beschreibt die DMA-Funktionen eines Netzadapters.

Syntax

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

Member

Size

Die Größe dieser Struktur in Bytes.

DmaEnabler

Das DMA-Enabler-Objekt, das vom Clienttreiber zum Zuordnen und Zuweisen von Arbeitsspeicher verwendet wird.

Wichtig

Beim Konfigurieren dieses Objekts mit der WDF_DMA_ENABLER_CONFIG-Struktur müssen Clienttreiber den WdmDmaVersionOverride-Member auf 3 festlegen, um DMA-Version 3 anzugeben.

MaximumPhysicalAddress

Die maximale physische Adresse, die beim Zuweisen von Speicherpuffern verwendet werden soll. Legen Sie diesen Member auf 0 fest, um anzugeben, dass keine maximale Adresse vorhanden ist.

CacheEnabled

Ein WDF_TRI_STATE Wert, der definiert, ob für den zugewiesenen Arbeitsspeicher der Cache aktiviert sein soll oder nicht. Wenn dieses Element auf WdfDefault festgelegt ist, wird der Cache nur aktiviert, wenn das Gerät im Cache kohärent ist.

PreferredNode

Der bevorzugte NUMA-Knoten, der bei der Zuweisung von Arbeitsspeicher verwendet werden soll. Wenn dieses Element auf MM_ANY_NODE_OK festgelegt ist, ermittelt NetAdapterCx automatisch den am besten zu verwendenden Knoten.

Hinweise

Rufen Sie NET_ADAPTER_DMA_CAPABILITIES_INIT auf, um diese Struktur zu initialisieren.

Diese Struktur kann entweder im Empfangspfad, als Member der NET_ADAPTER_RX_CAPABILITIES-Struktur oder im Übertragungspfad als Element der NET_ADAPTER_TX_CAPABILITIES-Struktur verwendet werden.

Anforderungen

Anforderung	Wert
KMDF-Mindestversion	1,27
Kopfzeile	netadapter.h (include netadaptercx.h)

Weitere Informationen

NET_ADAPTER_DMA_CAPABILITIES_INIT

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_TX_CAPABILITIES