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

Artigo
07/16/2024

Recupera um objeto DisplayInformation para o monitor especificado. GetForMonitor sempre aloca e retorna um novo DisplayInformation.

Sintaxe

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

Parâmetros

monitor

Tipo: [in]\ HMONITOR

O identificador do monitor.

riid

Tipo: [in]\ REFIID

O GUID da classe DisplayInformation.

displayInfo

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

Um ponteiro para um bloco de memória que recebe um ponteiro para o objeto DisplayInformation retornado.

Valor de retorno

Tipo: HRESULT

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

Observações

Considerações:

Os movimentos da janela não são rastreados, pois não há janela.
Qualquer fator de escala retornado pelo DisplayInformation é o fator de escala atual para todo o monitor. A virtualização de DPI atua da mesma forma que para GetScaleFactorForMonitor, que é a API subjacente usada para ler a escala nesse caso.
Se você quiser se registrar para eventos, o thread atual deverá ter um Windows.System.DispatcherQueue em execução para receber eventos. Essa DispatcherQueue será feita após a chamada para GetForMonitor . Se não houver DispatcherQueue, uma exceção (no nível da interface binária do aplicativo, um HRESULT) será retornada nos métodos de registro do manipulador de eventos.
O thread atual pode ser MTA ou STA.

Você é responsável por: armazenar em cache o displayInformation criado, desde que o argumento de monitore seja relevante; desativar o registro de manipuladores de eventos; e descartando a última referência para destruir a instância DisplayInformation.

Exemplos

Consulte o exemplo de código no IDisplayInformationStaticsInterop::GetForWindow.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Build 22621 do Windows 11
cabeçalho	windows.graphics.display.interop.h

Compartilhar via