NET_ADAPTER_DMA_CAPABILITIES結構 (netadapter.h)
NET_ADAPTER_DMA_CAPABILITIES 結構描述 net adapter 的 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) |