NET_ADAPTER_DMA_CAPABILITIES 構造体では、ネット アダプターの DMA 機能について説明します。
構文
typedef struct _NET_ADAPTER_DMA_CAPABILITIES {
ULONG Size;
WDFDMAENABLER DmaEnabler;
PHYSICAL_ADDRESS MaximumPhysicalAddress;
WDF_TRI_STATE CacheEnabled;
NODE_REQUIREMENT PreferredNode;
} NET_ADAPTER_DMA_CAPABILITIES;
メンバーズ
Size
この構造体のサイズ (バイト単位)。
DmaEnabler
メモリのマップと割り当てにクライアント ドライバーによって使用される DMA イネーブラー オブジェクト。
大事な
WDF_DMA_ENABLER_CONFIG 構造体を使用してこのオブジェクトを構成する場合、クライアント ドライバーは、WdmDmaVersionOverride メンバーを 3 に設定して DMA バージョン 3 を指定する必要があります。
MaximumPhysicalAddress
メモリ バッファーを割り当てるときに使用する最大物理アドレス。 このメンバーを 0 に設定して、最大アドレスがないことを示します。
CacheEnabled
割り当てられたメモリでキャッシュを有効にするかどうかを定義する WDF_TRI_STATE 値。 このメンバーが WdfDefault に設定されている場合、キャッシュは、デバイスがキャッシュコヒーレントである場合にのみ有効になります。
PreferredNode
メモリを割り当てるときに使用する優先 NUMA ノード。 このメンバーが MM_ANY_NODE_OKに設定されている場合、NetAdapterCx によって、使用する最適なノードが自動的に決定されます。
備考
この構造体を初期化するには、NET_ADAPTER_DMA_CAPABILITIES_INIT を呼び出します。
この構造体は、受信パス、NET_ADAPTER_RX_CAPABILITIES 構造体のメンバーとして、または送信パスで NET_ADAPTER_TX_CAPABILITIES 構造体のメンバーとして使用できます。
必要条件
| 要件 | 価値 |
|---|---|
| 最小 KMDF バージョン | 1.27 |
| ヘッダー | netadapter.h (netadaptercx.h を含む) |