Fonction QueryMemoryResourceNotification (memoryapi.h)

  • Article

Récupère l’état de l’objet de ressource mémoire spécifié.

Syntaxe

BOOL QueryMemoryResourceNotification(
  [in]  HANDLE ResourceNotificationHandle,
  [out] PBOOL  ResourceState
);

Paramètres

[in] ResourceNotificationHandle

Handle vers un objet de notification de ressource mémoire. La fonction CreateMemoryResourceNotification retourne ce handle.

[out] ResourceState

La mémoire pointée par ce paramètre reçoit l’état de l’objet de notification de ressource mémoire. La valeur de ce paramètre est définie sur TRUE si la condition de mémoire spécifiée existe, et FALSE si la condition de mémoire spécifiée n’existe pas.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour plus d’informations sur l’erreur, appelez GetLastError.

Notes

Contrairement aux fonctions d’attente, QueryMemoryResourceNotification ne bloque pas le thread appelant. Par conséquent, il s’agit d’un moyen efficace de case activée l’état de la mémoire physique avant de procéder à une opération.

Pour compiler une application qui utilise cette fonction, définissez la macro _WIN32_WINNT comme 0x0501 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Spécifications

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête memoryapi.h (inclure Windows.h, Memoryapi.h)
Bibliothèque onecore.lib
DLL Kernel32.dll

Voir aussi

CreateMemoryResourceNotification

Fonctions de gestion de la mémoire