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) |