WdfDmaTransactionGetBytesTransferred 函式 (wdfdmatransaction.h)

  • 發行項

[僅適用於 KMDF]

WdfDmaTransactionGetBytesTransferred 方法會傳回已針對指定 DMA 交易傳輸的位元組總數。

語法

size_t WdfDmaTransactionGetBytesTransferred(
  [in] WDFDMATRANSACTION DmaTransaction
);

參數

[in] DmaTransaction

驅動程式從先前呼叫 WdfDmaTransactionCreate 取得的 DMA 交易物件的句柄。

傳回值

WdfDmaTransactionGetBytesTransferred 會傳回已針對 DmaTransaction 參數指定的 DMA 交易傳輸的位元組總數。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

備註

架構型驅動程式通常會從 EvtInterruptDpc 事件回呼函式內呼叫 WdfDmaTransactionGetBytesTransferred，在所有 DMA 傳輸完成後，以取得最終傳輸的位元組計數。 驅動程式通常會使用最終位元組計數做為 WdfRequestCompleteWithInformation 方法的輸入。 如需此方法的詳細資訊，請參閱 完成 DMA 交易。

範例

如需使用 WdfDmaTransactionGetBytesTransferred 的程式碼範例，請參閱 WdfDmaTransactionDmaCompleted。

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfdmatransaction.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另請參閱

EvtInterruptDpc

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfRequestCompleteWithInformation