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

Article
2024-07-16

Récupère un objet DisplayInformation pour le moniteur spécifié. GetForMonitor alloue toujours et retourne un nouveau 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 de retour

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 l'DisplayInformation est le facteur d’échelle actuel pour l’ensemble du moniteur. La virtualisation DPI agit de la même façon que pour GetScaleFactorForMonitor, qui est l’API sous-jacente utilisée pour lire l’échelle dans ce cas.
Si vous souhaitez vous inscrire à des événements, le thread actuel doit avoir un Windows.System.DispatcherQueue en cours d’exécution, afin de recevoir des événements. Cette DispatcherQueue sera alignée sur l’appel à GetForMonitor. S’il n’existe aucun DispatcherQueue, une exception (au niveau de l’interface binaire de l’application, une 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 de la mise en cache de l' DisplayInformation créée tant que l’argument de surveiller est pertinent ; désinscrire des gestionnaires d’événements ; et la suppression de la dernière référence pour détruire l’instance DisplayInformation.

Exemples

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 11 Build 22621
d’en-tête	windows.graphics.display.interop.h

Partager via