Função CreateMemoryResourceNotification (memoryapi.h)

Cria um objeto de notificação de recurso de memória.

Sintaxe

HANDLE CreateMemoryResourceNotification(
  [in] MEMORY_RESOURCE_NOTIFICATION_TYPE NotificationType
);

Parâmetros

[in] NotificationType

A condição de memória sob a qual o objeto deve ser sinalizado. Esse parâmetro pode ser um dos seguintes valores da enumeração MEMORY_RESOURCE_NOTIFICATION_TYPE .

Valor	Significado
LowMemoryResourceNotification 0	A memória física disponível está em baixa.
HighMemoryResourceNotification 1	A memória física disponível é alta.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um identificador para um objeto de notificação de recurso de memória.

Se a função falhar, o valor retornado será NULL. Para obter informações estendidas, chame GetLastError.

Comentários

Os aplicativos podem usar eventos de notificação de recursos de memória para dimensionar o uso de memória conforme apropriado. Se a memória disponível estiver baixa, o aplicativo poderá reduzir seu conjunto de trabalho. Se a memória disponível for alta, o aplicativo poderá alocar mais memória.

Qualquer thread do processo de chamada pode especificar o identificador de notificação de recurso de memória em uma chamada para a função QueryMemoryResourceNotification ou uma das funções de espera. O estado do objeto é sinalizado quando a condição de memória especificada existe. Esse é um evento em todo o sistema, portanto, todos os aplicativos recebem notificação quando o objeto é sinalizado. Observe que há um intervalo de disponibilidade de memória em que nem o objeto LowMemoryResourceNotification nem HighMemoryResourceNotification são sinalizados. Nesse caso, os aplicativos devem tentar manter o uso de memória constante.

Use a função CloseHandle para fechar o identificador. O sistema fecha o identificador automaticamente quando o processo é encerrado. O objeto de notificação de recurso de memória é destruído quando seu último identificador é fechado.

Para compilar um aplicativo que usa essa função, defina a macro _WIN32_WINNT como 0x0501 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	memoryapi.h (inclua Windows.h, Memoryapi.h)
Biblioteca	onecore.lib
DLL	Kernel32.dll

Confira também

CloseHandle

Funções de gerenciamento da memória

QueryMemoryResourceNotification