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 |