共用方式為


WdfDmaTransactionGetTransferInfo 函式 (wdfdmatransaction.h)

[僅適用於 KMDF]

WdfDmaTransactionGetTransferInfo 方法會傳回初始化 DMA 交易所需的地圖緩存器和散佈/收集清單項目數目。

語法

void WdfDmaTransactionGetTransferInfo(
  [in]            WDFDMATRANSACTION DmaTransaction,
  [out, optional] ULONG             *MapRegisterCount,
  [out, optional] ULONG             *ScatterGatherElementCount
);

參數

[in] DmaTransaction

初始化之 DMA 交易物件的句柄。

[out, optional] MapRegisterCount

呼叫端提供的位置,傳回時會包含指定交易所需的地圖緩存器數目。 這個參數是選擇性的,而且可以是 NULL。

[out, optional] ScatterGatherElementCount

傳回時,呼叫端提供的位置包含指定交易所需的散佈/收集元素數目。 這個參數是選擇性的,而且可以是 NULL。

返回值

沒有

備註

驅動程式可能會在呼叫 WdfDmaTransactionAllocateResources WdfDmaTransactionExecute 之前呼叫 WdfDmaTransactionGetTransferInfo

使用 DMA 第 3 版時,這個方法會傳回所需地圖緩存器數目的準確計數。 使用舊版 DMA 時,此方法會假設每個頁面都需要地圖緩存器。

需求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.11
標題 wdfdmatransaction.h (包括 Wdf.h)
程式庫 Wdf01000.sys (請參閱架構連結庫版本控制。)
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate(kmdf)

另請參閱

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute