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 |
|---|---|
|
A memória física disponível está em baixa. |
|
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 |