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)