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 |
| ヘッダー | wdfdmatransaction.h (Wdf.h を含む) |
| 図書館 | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |