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.
HRESULT GetForMonitor(
HMONITOR monitor,
REFIID riid,
void **displayInfo
);
monitor
Handle du moniteur.
riid
GUID
displayInfo
Type : [iid_is][retval][out] void**
Pointeur vers un bloc de mémoire qui reçoit un pointeur vers l’objet DisplayInformation retourné.
Type : HRESULT
Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
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
Consultez l’exemple de code dans IDisplayInformationStaticsInterop ::GetForWindow.
Exigence | Valeur |
---|---|
client minimum pris en charge | Windows 11 Build 22621 |
d’en-tête | windows.graphics.display.interop.h |