Partager via


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

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’erreurHRESULT.

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