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)

こちらもご覧ください

WdfDmaTransactionAllocateResources