AddSecureMemoryCacheCallback

セキュアなメモリ範囲が解放されたり、保護属性が変更されたりしたときに呼ばれるコールバック関数を登録する。

AddSecureMemoryCacheCallback pfnCallBack

pfnCallBack : [int] 登録するアプリケーション定義の SecureMemoryCacheCallback 関数へのポインタ。

(プラグイン / モジュール : kernel32.dll)

解説

セキュアなメモリ範囲が解放されたり、保護属性が変更されたりしたときに呼ばれるコールバック関数を登録する。

[戻り値]
関数が成功した場合、コールバック関数を登録し TRUE を返す。関数が失敗した場合、FALSE を返す。拡張エラー情報を取得するには
GetLastError 関数を呼ぶ。

[備考]
高性能デバイスに対して直接 I/O を行うアプリケーションは、通常、I/O
用バッファに対する仮想アドレスから物理メモリへのマッピングをキャッシュする。デバイスドライバは通常、MmSecureVirtualMemory
ルーチンを呼んでこのメモリアドレス範囲をセキュアにし、ドライバがセキュア解除するまでメモリ範囲が解放されたり保護属性が変更されたりするのを防ぐ。アプリケーションは
AddSecureMemoryCacheCallback
を使って、メモリが解放されたり保護属性が変更されたりしたときに呼ばれるコールバック関数を登録し、キャッシュしたメモリマッピングを無効化できる。詳細は
SecureMemoryCacheCallback
を参照。この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT を 0x0600 以降として定義する。詳細は
Using the Windows Headers を参照。

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs