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」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfdmatransaction.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |