Funzione QueryMemoryResourceNotification (memoryapi.h)
Recupera lo stato dell'oggetto risorsa di memoria specificato.
Sintassi
BOOL QueryMemoryResourceNotification(
[in] HANDLE ResourceNotificationHandle,
[out] PBOOL ResourceState
);
Parametri
[in] ResourceNotificationHandle
Handle per un oggetto di notifica della risorsa di memoria. La funzione CreateMemoryResourceNotification restituisce questo handle.
[out] ResourceState
La memoria a cui punta questo parametro riceve lo stato dell'oggetto notifica della risorsa di memoria. Il valore di questo parametro è impostato su TRUE se esiste la condizione di memoria specificata e FALSE se la condizione di memoria specificata non esiste.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per altre informazioni sugli errori, chiamare GetLastError.
Commenti
A differenza delle funzioni di attesa, QueryMemoryResourceNotification non blocca il thread chiamante. Pertanto, è un modo efficiente per controllare lo stato della memoria fisica prima di procedere con un'operazione.
Per compilare un'applicazione che usa questa funzione, definire la macro _WIN32_WINNT come 0x0501 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | memoryapi.h (include Windows.h, Memoryapi.h) |
| Libreria | onecore.lib |
| DLL | Kernel32.dll |