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)

另請參閱

NET_ADAPTER_DMA_CAPABILITIES_INIT

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_TX_CAPABILITIES