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

Confira também

Creatememoryresourcenotification

Funções de gerenciamento da memória