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

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

Sintaxis

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

Parámetros

monitor

Tipo: [in]\ HMONITOR

Identificador del monitor.

riid

Tipo: [in]\ REFIID

GUID de la clase DisplayInformation.

displayInfo

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

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

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de errorHRESULT.

Comentarios

Consideraciones:

• No se realiza un seguimiento de los movimientos de ventana, ya que no hay ninguna ventana.
• Cualquier factor de escala devuelto por 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 para 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, 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 del monitor sea relevante; anular el registro de 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	Value
Cliente mínimo compatible	Windows 11 compilación 22621
Encabezado	windows.graphics.display.interop.h