WdfDmaTransactionGetDevice 関数 (wdfdmatransaction.h)
[KMDF にのみ適用]
WdfDmaTransactionGetDevice メソッドは、指定された DMA トランザクションに関連付けられているフレームワーク デバイス オブジェクトへのハンドルを返します。
構文
WDFDEVICE WdfDmaTransactionGetDevice(
[in] WDFDMATRANSACTION DmaTransaction
);
パラメーター
[in] DmaTransaction
ドライバーが WdfDmaTransactionCreate の以前の呼び出しから取得した DMA トランザクション オブジェクトへのハンドル。
戻り値
WdfDmaTransactionGetDevice は、ドライバーが WdfDmaTransactionCreate を呼び出したときに指定したフレームワーク デバイス オブジェクトへのハンドルを返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
注釈
DMA 転送の完了の詳細については、「DMA 転送 の完了」を参照してください。
例
次のコード例では、指定した DMA トランザクションに関連付けられているフレームワーク デバイス オブジェクトへのハンドルを取得します。
WDFDEVICE device;
device = WdfDmaTransactionGetDevice(DmaTransaction);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfdmatransaction.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |