[僅適用於 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） |