メモリを割り当てたモジュールがアンロードされたときにリークとしてフラグが設定されないように、アプリケーション検証ツールによる追跡から割り当てを削除します。
構文
NTSTATUS WINAPI RtlDisownModuleHeapAllocation(
_In_ HANDLE HeapHandle,
_In_ PVOID Allocation
);
パラメーター
HeapHandle
型: HANDLE
割り当てが行われるヒープ ハンドル。
Allocation
種類: PVOID
アプリケーション検証ツールのリーク追跡によって無視されるメモリ割り当てへのポインター。
戻り値
STATUS_SUCCESSを返します。
解説
RtlDisownModuleHeapAllocation は、割り当てを割り当てたモジュールより長く割り当てられる可能性があることをアプリケーション検証ツールが期待できるように提供されます。 その場合、アプリケーション検証ツールは、割り当てを行ったモジュールがアンロードされたときにリークとしてフラグが設定されないように、内部追跡から割り当てを削除できます。 アプリケーション検証ツールが有効になっていない場合、この関数は操作不要です。
RtlDisownModuleHeapAllocation はヘッダー ファイルに関連付けられません。 ただし、関連付けられているインポート ライブラリ である は、 Ntdll.libWindows Driver Kit (WDK) で使用できます。 最初に LoadLibrary 関数を使用して (読み込むNtdll.dll)、次に GetProcAddress 関数を呼び出して RtlDisownModuleHeapAllocation のアドレスを取得することで、RtlDisownModuleHeapAllocation を呼び出すこともできます。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | 該当なし |
| Library | Windows ドライバー キット (WDK) の Ntdll.lib |
| [DLL] | Ntdll.dll |