Share via

Función RegisterScaleChangeEvent (shellscalingapi.h)

  • Artículo

Registra un evento que se desencadena cuando la escala ha cambiado posiblemente. Esta función reemplaza a RegisterScaleChangeNotifications.

Sintaxis

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

Parámetros

[in] hEvent

Identificador del evento que se va a registrar para las notificaciones de cambio de escalado.

[out] pdwCookie

Cuando esta función vuelve correctamente, este valor recibe la dirección de un puntero a una cookie que se puede usar más adelante para anular el registro de las notificaciones de cambio de escala a través de UnregisterScaleChangeEvent.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El evento se genera cada vez que algo que puede afectar a los cambios de escala, pero solo porque la escala puede verse afectada no significa que haya sido. Los autores de llamadas pueden almacenar en caché el factor de escala para comprobar que la escala del monitor ha cambiado realmente. El identificador de eventos se duplicará, por lo que los autores de llamadas pueden cerrar su identificador en cualquier momento.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shellscalingapi.h
Library Shcore.lib
Archivo DLL Shcore.dll

Consulte también

GetScaleFactorForMonitor

AnularregisterScaleChangeEvent