Metodo IDisplayInformationStaticsInterop::GetForMonitor (windows.graphics.display.interop.h)

Articolo
07/16/2024

Recupera un oggetto DisplayInformation per il monitoraggio specificato. GetForMonitor alloca sempre e restituisce un nuovo DisplayInformation.

Sintassi

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

Parametri

monitor

Tipo: [in]\ HMONITOR

Handle del monitoraggio.

riid

Tipo: [in]\ REFIID

GUID della classe DisplayInformation .

displayInfo

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

Puntatore a un blocco di memoria che riceve un puntatore all'oggetto DisplayInformation restituito.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di erroreHRESULT .

Osservazioni

Considerazioni:

I movimenti delle finestre non vengono rilevati, perché non è presente alcuna finestra.
Qualsiasi fattore di scala restituito dal DisplayInformation è il fattore di scala corrente per l'intero monitor. La virtualizzazione DPI funziona allo stesso modo di GetScaleFactorForMonitor, che è l'API sottostante usata per leggere la scalabilità in questo caso.
Se si desidera eseguire la registrazione per gli eventi, il thread corrente deve avere un Windows.System.DispatcherQueue in esecuzione, per ricevere eventi. Tale DispatcherQueue verrà bloccato alla chiamata a GetForMonitor. Se non è presente DispatcherQueue, viene restituita un'eccezione (a livello di interfaccia binaria dell'applicazione, un HRESULT) nei metodi di registrazione del gestore eventi.
Il thread corrente può essere MTA o STA.

Sei responsabile della memorizzazione nella cache del DisplayInformation creato finché l'argomento di monitor è rilevante; deregistrazione dei gestori eventi; e rilasciando l'ultimo riferimento per distruggere l'istanza DisplayInformation .

Esempi

Vedere l'esempio di codice in IDisplayInformationStaticsInterop::GetForWindow.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 11 Build 22621
intestazione	windows.graphics.display.interop.h

Condividi tramite