WdfDmaTransactionFreeResources 関数 (wdfdmatransaction.h)
[KMDF にのみ適用]
WdfDmaTransactionFreeResources メソッドは、ドライバーが WdfDmaTransactionAllocateResources を呼び出して以前に割り当てた DMA リソースを解放します。
構文
void WdfDmaTransactionFreeResources(
[in] WDFDMATRANSACTION DmaTransaction
);
パラメーター
[in] DmaTransaction
ドライバーが WdfDmaTransactionAllocateResources の以前の呼び出しで提供した DMA トランザクション オブジェクトへのハンドル。
戻り値
なし
解説
WdfDmaTransactionFreeResources は、パケットまたはシステム プロファイルを指定する DMA イネーブラーと共に使用する必要があります。
Windows 8より前のオペレーティング システムでは、単一パケット DMA イネーブラーを指定するイネーブラーと共に WdfDmaTransactionFreeResources を使用する必要があります。 Windows 8以降、WdfDmaTransactionFreeResources は、システム モード DMA イネーブラーを指定するイネーブラーと共に使用することもできます。
散布/収集 DMA イネーブラーを使用して呼び出されると、WdfDmaTransactionFreeResources によって検証ツールのバグチェックが発生します。
WdfDmaTransactionFreeResources に対するドライバーの呼び出しにより、フレームワークが EvtProgramDma または EvtReserveDma をすぐに呼び出す可能性があります。
システム モード DMA の詳細については、「 System-Mode DMA のサポート」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.11 |
| Header | wdfdmatransaction.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf) |