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 |