Поделиться через


Функция AddSecureMemoryCacheCallback (winbase.h)

Регистрирует функцию обратного вызова для вызова при освобождении защищенного диапазона памяти или изменении его защиты.

Синтаксис

BOOL AddSecureMemoryCacheCallback(
  [in] PSECURE_MEMORY_CACHE_CALLBACK pfnCallBack
);

Параметры

[in] pfnCallBack

Указатель на определяемую приложением функцию SecureMemoryCacheCallback для регистрации.

Возвращаемое значение

Если функция выполняется успешно, она регистрирует функцию обратного вызова и возвращает значение TRUE.

Если функция завершается сбоем, она возвращает значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .

Комментарии

Приложение, выполняющее операции ввода-вывода непосредственно на высокопроизводительном устройстве, обычно кэширует сопоставление виртуальной и физической памяти для буфера, используемого для операций ввода-вывода. Драйвер устройства обычно защищает этот диапазон адресов памяти, вызывая подпрограмму MmSecureVirtualMemory , которая предотвращает освобождение диапазона памяти или изменение его защиты до тех пор, пока драйвер не отключит память.

Приложение может использовать AddSecureMemoryCacheCallback для регистрации функции обратного вызова, которая будет вызываться при освобождении памяти или изменении ее защиты, поэтому приложение может сделать недействительным сопоставление кэшированных памяти. Дополнительные сведения см. в разделе SecureMemoryCacheCallback.

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0600 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Требования

Требование Значение
Минимальная версия клиента Windows Vista с пакетом обновления 1 (SP1) [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

RemoveSecureMemoryCacheCallback

SecureMemoryCacheCallback