Função AddSecureMemoryCacheCallback (winbase.h)

Registra uma função de retorno de chamada a ser chamada quando um intervalo de memória protegido é liberado ou suas proteções são alteradas.

Sintaxe

BOOL AddSecureMemoryCacheCallback(
  [in] PSECURE_MEMORY_CACHE_CALLBACK pfnCallBack
);

Parâmetros

[in] pfnCallBack

Um ponteiro para a função SecureMemoryCacheCallback definida pelo aplicativo a ser registrada.

Retornar valor

Se a função for bem-sucedida, ela registrará a função de retorno de chamada e retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame a função GetLastError.

Comentários

Um aplicativo que executa E/S diretamente para um dispositivo de alto desempenho normalmente armazena em cache um mapeamento de memória virtual para física para o buffer que ele usa para a E/S. O driver do dispositivo normalmente protege esse intervalo de endereços de memória chamando a rotina MmSecureVirtualMemory , o que impede que o intervalo de memória seja liberado ou suas proteções sejam alteradas até que o driver desprotegre a memória.

Um aplicativo pode usar AddSecureMemoryCacheCallback para registrar uma função de retorno de chamada que será chamada quando a memória for liberada ou suas proteções forem alteradas, para que o aplicativo possa invalidar seu mapeamento de memória em cache. Para obter mais informações, consulte SecureMemoryCacheCallback.

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (incluir Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Confira também

RemoveSecureMemoryCacheCallback

SecureMemoryCacheCallback