Compartir a través de


Función AddSecureMemoryCacheCallback (winbase.h)

Registra una función de devolución de llamada que se va a llamar cuando se libera un intervalo de memoria protegido o se cambian sus protecciones.

Sintaxis

BOOL AddSecureMemoryCacheCallback(
  [in] PSECURE_MEMORY_CACHE_CALLBACK pfnCallBack
);

Parámetros

[in] pfnCallBack

Puntero a la función SecureMemoryCacheCallback definida por la aplicación que se va a registrar.

Valor devuelto

Si la función se realiza correctamente, registra la función de devolución de llamada y devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Para obtener información ampliada de los errores, llame a la función GetLastError.

Comentarios

Una aplicación que realiza E/S directamente en un dispositivo de alto rendimiento suele almacenar en caché una asignación de memoria virtual a física para el búfer que usa para la E/S. El controlador del dispositivo normalmente protege este intervalo de direcciones de memoria mediante una llamada a la rutina MmSecureVirtualMemory , lo que impide que el intervalo de memoria se libere o sus protecciones cambien hasta que el controlador no proteja la memoria.

Una aplicación puede usar AddSecureMemoryCacheCallback para registrar una función de devolución de llamada a la que se llamará cuando se libere la memoria o se cambien sus protecciones, por lo que la aplicación puede invalidar su asignación de memoria almacenada en caché. Para más información, consulte SecureMemoryCacheCallback.

Para compilar una aplicación que usa esta función, defina _WIN32_WINNT como 0x0600 o posterior. Para obtener más información, vea Usar los encabezados de Windows.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

RemoveSecureMemoryCacheCallback

SecureMemoryCacheCallback