Compartir a través de

Método IDisplayInformationStaticsInterop::GetForMonitor (windows.graphics.display.interop.h)

  • Artículo

Recupera un objeto DisplayInformation para el monitor especificado. GetForMonitor siempre asigna y devuelve un nuevo DisplayInformation.

Sintaxis

HRESULT GetForMonitor(
  HMONITOR monitor,
  REFIID   riid,
  void     **displayInfo
);

Parámetros

monitor

Tipo: [in]\ HMONITOR

Identificador del monitor.

riid

Tipo: [in]\ REFIID

GUID de de la clase displayInformation de .

displayInfo

Tipo: [iid_is][retval][out] void**

Puntero a un bloque de memoria que recibe un puntero al objeto DisplayInformation devuelto displayInformation.

Valor devuelto

Tipo: HRESULT

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

Observaciones

Consideraciones:

  • No se realiza un seguimiento de los movimientos de ventana, ya que no hay ninguna ventana.
  • Cualquier factor de escala devuelto por el DisplayInformation es el factor de escala actual para todo el monitor. La virtualización de PPP actúa de la misma manera que para GetScaleFactorForMonitor, que es la API subyacente que se usa para leer la escala en este caso.
  • Si desea registrarse para eventos, el subproceso actual debe tener un Windows.System.DispatcherQueue en ejecución, con el fin de recibir eventos. Ese DispatcherQueue se ajustará en la llamada a GetForMonitor. Si no hay dispatcherQueue, se devuelve una excepción (en el nivel de interfaz binaria de la aplicación, se devuelve un HRESULT) en los métodos de registro del controlador de eventos.
  • El subproceso actual puede ser MTA o STA.

Usted es responsable de: almacenar en caché la displayInformation creada siempre que el argumento de monitor sea relevante; desconscribir controladores de eventos; y quitar la última referencia para destruir la instancia de DisplayInformation.

Ejemplos

Vea el ejemplo de código en IDisplayInformationStaticsInterop::GetForWindow.

Requisitos

Requisito Valor
cliente mínimo admitido Compilación 22621 de Windows 11
encabezado de windows.graphics.display.interop.h