Función QueryMemoryResourceNotification (memoryapi.h)
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 |