WdfDmaTransactionGetRequest 関数 (wdfdmatransaction.h)

[KMDF にのみ適用]

WdfDmaTransactionGetRequest メソッドは、指定された DMA トランザクションに関連付けられているフレームワーク要求オブジェクトへのハンドルを取得します。

構文

WDFREQUEST WdfDmaTransactionGetRequest(
  [in] WDFDMATRANSACTION DmaTransaction
);

パラメーター

[in] DmaTransaction

ドライバーが WdfDmaTransactionCreate の以前の呼び出しから取得した DMA トランザクション オブジェクトへのハンドル。

戻り値

WdfDmaTransactionGetRequest は、 DmaTransaction パラメーターが指定した DMA トランザクションに関連付けられているフレームワーク要求オブジェクトへのハンドルを返します。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

ドライバーは 、WdfDmaTransactionInitializeUsingRequest を呼び出すことによってドライバーが作成した DMA トランザクションに対してのみ WdfDmaTransactionGetRequest を呼び出すことができます。 ドライバーが WdfDmaTransactionInitialize を呼び出して作成した DMA トランザクションに対して WdfDmaTransactionGetRequest を呼び出すと、 WdfDmaTransactionGetRequest は NULL を返します。

DMA 転送の完了の詳細については、「DMA 転送 の完了」を参照してください。

例

次のコード例では、指定した DMA トランザクションに関連付けられているフレームワーク要求オブジェクトへのハンドルを取得します。

WDFREQUEST  request;

request = WdfDmaTransactionGetRequest(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)

こちらもご覧ください

WdfDmaTransactionCreate

WdfDmaTransactionInitialize

WdfDmaTransactionInitializeUsingRequest