Função QueryMemoryResourceNotification (memoryapi.h)
Recupera o estado do objeto de recurso de memória especificado.
Sintaxe
BOOL QueryMemoryResourceNotification(
[in] HANDLE ResourceNotificationHandle,
[out] PBOOL ResourceState
);
Parâmetros
[in] ResourceNotificationHandle
Um identificador para um objeto de notificação de recurso de memória. A função CreateMemoryResourceNotification retorna esse identificador.
[out] ResourceState
A memória apontada por esse parâmetro recebe o estado do objeto de notificação de recurso de memória. O valor desse parâmetro será definido como TRUE se a condição de memória especificada existir e FALSE se a condição de memória especificada não existir.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter mais informações de erro, chame GetLastError.
Comentários
Ao contrário das funções de espera, QueryMemoryResourceNotification não bloqueia o thread de chamada. Portanto, é uma maneira eficiente de marcar o estado da memória física antes de prosseguir com uma operação.
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 |