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