SecureMemoryCacheCallback callback function
An application-defined function previously registered with the AddSecureMemoryCacheCallback function that is called when a secured memory range is freed or its protections are changed.
The PSECURE_MEMORY_CACHE_CALLBACK type defines a pointer to this callback function. SecureMemoryCacheCallback is a placeholder for the application-defined function name.
BOOLEAN CALLBACK SecureMemoryCacheCallback( _In_ PVOID Addr, _In_ SIZE_T Range ); typedef BOOLEAN (*PSECURE_MEMORY_CACHE_CALLBACK)( _In_ PVOID Addr, _In_ SIZE_T Range );
- Addr [in]
The starting address of the memory range.
- Range [in]
The size of the memory range, in bytes.
The return value indicates the success or failure of this function.
If the caller has secured the specified memory range, this function should unsecure the memory and return TRUE.
If the caller has not secured the specified memory range, this function should return FALSE.
After the callback function is registered, it is called after any attempt to free the specified memory range or change its protections. If the application has secured any part of the specified memory range, the callback function must invalidate all of the application's cached memory mappings for the secured memory range, unsecure the secured parts of the memory range, and return TRUE. Otherwise it must return FALSE.
The application secures and unsecures a memory range by sending requests to a device driver, which uses the MmSecureVirtualMemory and MmUnsecureVirtualMemory functions to actually secure and unsecure the range. Operations on other types of secured or locked memory do not trigger this callback.
The callback function can also be triggered by a heap operation. In this case, the function must not perform any further operations on the heap that triggered the callback. This includes calling heap functions on a private heap or the process's default heap, or calling standard library functions such as malloc and free, which implicitly use the process's default heap.
To unregister the callback function, use the RemoveSecureMemoryCacheCallback function.
Minimum supported client
|Windows Vista with SP1 [desktop apps only]|
Minimum supported server
|Windows Server 2008 [desktop apps only]|