[KMDF にのみ適用]
WdfDmaTransactionWdmGetTransferContext メソッドは、DMA トランザクションに関連付けられている WDM 転送コンテキストを取得します。
構文
PVOID WdfDmaTransactionWdmGetTransferContext(
[in] WDFDMATRANSACTION DmaTransaction
);
パラメーター
[in] DmaTransaction
転送コンテキストの取得元となる初期化された DMA トランザクション オブジェクトへのハンドル。
戻り値
トランザクションに関連付けられている DMA 転送コンテキスト (PTRANSFER_CONTEXT) へのポインター。
注釈
トランザクションの DMA 転送コンテキストは、ドライバーがトランザクションを作成するときに割り当てられます。
WdfDmaTransactionWdmGetTransferContext は、DMA バージョン 3 を使用する DMA イネーブラーと共に使用する必要があります。 バージョン 3 を選択するには、WDF_DMA_ENABLER_CONFIG の WdmDmaVersionOverride メンバーを 3 に設定します。
ドライバーは、DMA 転送コンテキストを使用して、次の WDM DMA ライブラリ ルーチンを直接呼び出すことができます。
- AllocateAdapterChannelEx の
- CancelAdapterChannel の
- CancelMappedTransfer の
- GetScatterGatherListEx を する
- BuildScatterGatherListEx
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 |
| ターゲット プラットフォーム の | 普遍 |
| 最小 KMDF バージョン | 1.11 |
| ヘッダー | wdfdmatransaction.h (Wdf.h を含む) |
| 図書館 | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf) |