Share via

Función QueryMemoryResourceNotification (memoryapi.h)

  • Artículo

Recupera el estado del objeto de recurso de memoria especificado.

Sintaxis

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

Parámetros

[in] ResourceNotificationHandle

Identificador de un objeto de notificación de recursos de memoria. La función CreateMemoryResourceNotification devuelve este identificador.

[out] ResourceState

La memoria a la que apunta este parámetro recibe el estado del objeto de notificación de recursos de memoria. El valor de este parámetro se establece en TRUE si existe la condición de memoria especificada y FALSE si la condición de memoria especificada no existe.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener más información de error, llame a GetLastError.

Comentarios

A diferencia de las funciones de espera, QueryMemoryResourceNotification no bloquea el subproceso de llamada. Por lo tanto, es una manera eficaz de comprobar el estado de la memoria física antes de continuar con una operación.

Para compilar una aplicación que use esta función, defina la macro _WIN32_WINNT como 0x0501 o posterior. Para obtener más información, vea Uso de los encabezados de Windows.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado memoryapi.h (incluya Windows.h, Memoryapi.h)
Library onecore.lib
Archivo DLL Kernel32.dll

Vea también

CreateMemoryResourceNotification

Funciones de administración de memoria