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

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