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

Article
08/27/2023

Récupère un objet DisplayInformation pour le moniteur spécifié. GetForMonitor alloue et retourne toujours une nouvelle DisplayInformation.

Syntaxe

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

Paramètres

monitor

Type : [in]\ HMONITOR

Handle du moniteur.

riid

Type : [in]\ REFIID

GUID de la classe DisplayInformation.

displayInfo

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

Pointeur vers un bloc de mémoire qui reçoit un pointeur vers l’objet DisplayInformation retourné.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Considérations :

Les mouvements de fenêtre ne sont pas suivis, car il n’y a pas de fenêtre.
Tout facteur d’échelle retourné par DisplayInformation est le facteur d’échelle actuel pour l’ensemble du moniteur. La virtualisation PPP agit de la même manière que pour GetScaleFactorForMonitor, qui est l’API sous-jacente utilisée pour la mise à l’échelle de lecture dans ce cas.
Si vous souhaitez vous inscrire aux événements, le thread actuel doit avoir un Windows.System.DispatcherQueue en cours d’exécution pour recevoir des événements. Cette dispatcherQueue sera ancrée lors de l’appel à GetForMonitor. En l’absence de DispatcherQueue, une exception (au niveau de l’interface binaire de l’application, un HRESULT) est retournée dans les méthodes d’inscription du gestionnaire d’événements.
Le thread actuel peut être MTA ou STA.

Vous êtes responsable des opérations suivantes : mettre en cache l’élément DisplayInformation créé tant que l’argument du moniteur est pertinent ; désinscrire les gestionnaires d’événements ; et la suppression de la dernière référence afin de détruire l’instance DisplayInformation.

Exemples

Consultez l’exemple de code dans IDisplayInformationStaticsInterop ::GetForWindow.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 11 Build 22621
En-tête	windows.graphics.display.interop.h

Partager via