Função RegisterScaleChangeEvent (shellscalingapi.h)

Registra-se para um evento que é disparado quando a escala possivelmente foi alterada. Essa função substitui RegisterScaleChangeNotifications.

Sintaxe

HRESULT RegisterScaleChangeEvent(
  [in]  HANDLE    hEvent,
  [out] DWORD_PTR *pdwCookie
);

Parâmetros

[in] hEvent

Identificador do evento a ser registrado para notificações de alteração de escala.

[out] pdwCookie

Quando essa função retorna com êxito, esse valor recebe o endereço de um ponteiro para um cookie que pode ser usado posteriormente para cancelar o registro das notificações de alteração de escala por meio de UnregisterScaleChangeEvent.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O evento é gerado sempre que algo que pode afetar as alterações de escala, mas apenas porque a escala pode ser afetada não significa que tenha sido. Os chamadores podem armazenar em cache o fator de escala para verificar se a escala do monitor realmente foi alterada. O identificador de evento será duplicado, para que os chamadores possam fechar o identificador a qualquer momento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shellscalingapi.h
Biblioteca	Shcore.lib
DLL	Shcore.dll

Confira também

GetScaleFactorForMonitor

UnregisterScaleChangeEvent