Función CreateMemoryResourceNotification (memoryapi.h)

Crea un objeto de notificación de recursos de memoria.

Sintaxis

HANDLE CreateMemoryResourceNotification(
  [in] MEMORY_RESOURCE_NOTIFICATION_TYPE NotificationType
);

Parámetros

[in] NotificationType

Condición de memoria con la que se va a señalar el objeto. Este parámetro puede ser uno de los siguientes valores de la enumeración MEMORY_RESOURCE_NOTIFICATION_TYPE .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador de un objeto de notificación de recursos de memoria.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información extendida, llame a GetLastError.

Comentarios

Las aplicaciones pueden usar eventos de notificación de recursos de memoria para escalar el uso de memoria según corresponda. Si la memoria disponible es baja, la aplicación puede reducir su espacio de trabajo. Si la memoria disponible es alta, la aplicación puede asignar más memoria.

Cualquier subproceso del proceso de llamada puede especificar el identificador de notificación de recursos de memoria en una llamada a la función QueryMemoryResourceNotification o a una de las funciones de espera. El estado del objeto se señala cuando existe la condición de memoria especificada. Se trata de un evento en todo el sistema, por lo que todas las aplicaciones reciben notificaciones cuando se señala el objeto. Tenga en cuenta que hay un intervalo de disponibilidad de memoria donde no se señala ni el objeto LowMemoryResourceNotification ni HighMemoryResourceNotification . En este caso, las aplicaciones deben intentar mantener constante el uso de memoria.

Use la función CloseHandle para cerrar el identificador. El sistema cierra el identificador automáticamente cuando finaliza el proceso. El objeto de notificación de recursos de memoria se destruye cuando se ha cerrado su último identificador.

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

Vea también

CloseHandle

Funciones de administración de memoria

QueryMemoryResourceNotification