Funzione AddSecureMemoryCacheCallback (winbase.h)

Registra una funzione di callback da chiamare quando viene liberato un intervallo di memoria protetto o le relative protezioni vengono modificate.

Sintassi

BOOL AddSecureMemoryCacheCallback(
  [in] PSECURE_MEMORY_CACHE_CALLBACK pfnCallBack
);

Parametri

[in] pfnCallBack

Puntatore alla funzione SecureMemoryCacheCallback definita dall'applicazione per registrare.

Valore restituito

Se la funzione ha esito positivo, registra la funzione di callback e restituisce TRUE.

Se la funzione ha esito negativo, restituisce FALSE. Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

Commenti

Un'applicazione che esegue l'I/O direttamente in un dispositivo ad alte prestazioni memorizza in genere nella cache un mapping di memoria virtuale-fisica per il buffer usato per l'I/O. Il driver del dispositivo protegge in genere questo intervallo di indirizzi di memoria chiamando la routine MmSecureVirtualMemory , che impedisce che l'intervallo di memoria venga liberato o le relative protezioni non vengano modificate fino a quando il driver non protegge la memoria.

Un'applicazione può usare AddSecureMemoryCacheCallback per registrare una funzione di callback che verrà chiamata quando la memoria viene liberata o le relative protezioni vengono modificate, in modo che l'applicazione possa invalidare il mapping della memoria memorizzata nella cache. Per altre informazioni, vedere SecureMemoryCacheCallback.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista con SP1 [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winbase.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

RemoveSecureMemoryCacheCallback

SecureMemoryCacheCallback