AddSecureMemoryCacheCallback 函数 (winbase.h)

注册在释放安全内存范围或更改其保护时要调用的回调函数。

语法

BOOL AddSecureMemoryCacheCallback(
  [in] PSECURE_MEMORY_CACHE_CALLBACK pfnCallBack
);

参数

[in] pfnCallBack

指向要注册的应用程序定义的 SecureMemoryCacheCallback 函数的指针。

返回值

如果该函数成功,它将注册回调函数并返回 TRUE

如果函数失败,则返回 FALSE。 若要获得更多的错误信息,请调用 GetLastError 函数。

注解

直接对高性能设备执行 I/O 的应用程序通常会缓存用于 I/O 的缓冲区的虚拟到物理内存映射。 设备的驱动程序通常通过调用 MmSecureVirtualMemory 例程来保护此内存地址范围,该例程阻止释放内存范围或其保护发生更改,直到驱动程序解除内存安全。

应用程序可以使用 AddSecureMemoryCacheCallback 注册在释放内存或更改其保护时将调用的回调函数,以便应用程序可以使其缓存的内存映射失效。 有关详细信息,请参阅 SecureMemoryCacheCallback

若要编译使用此函数的应用程序, 请将_WIN32_WINNT 定义为 0x0600 或更高版本。 有关详细信息,请参阅 使用 Windows 标头

要求

要求
最低受支持的客户端 Windows Vista SP1 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 winbase.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

RemoveSecureMemoryCacheCallback

SecureMemoryCacheCallback