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

Vedere anche

CreateMemoryResourceNotification

Funzioni di gestione della memoria