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