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) |