DisplayMonitor Classe

Définition

Espace de noms:

Windows.Devices.Display

Fournit des informations sur un appareil de moniteur d’affichage connecté au système.

Ces données incluent des informations couramment utilisées à partir des données d’identification d’affichage étendue (EDID, qui est un bloc descripteur d’affichage standard que presque tous les moniteurs utilisent pour fournir des descriptions des modes pris en charge et des informations générales sur l’appareil) et DisplayID (qui est une norme industrielle plus récente qui fournit un sur-ensemble d’EDID).

public ref class DisplayMonitor sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DisplayMonitor final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DisplayMonitor

Public NotInheritable Class DisplayMonitor

Héritage

Object Platform::Object IInspectable DisplayMonitor

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1803 (introduit dans 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v6.0)

Remarques

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
2004	19041	IsDolbyVisionSupportedInHdrMode

Propriétés

BluePrimary	Obtient le point primaire bleu de chromaticité (calculé à partir des données d’identification d’affichage étendu ou EDID du moniteur et des remplacements de pilote).
ConnectionKind	Obtient une valeur représentant la méthode abstraite dans laquelle l’affichage est connecté (non spécifique à un protocole physique).
DeviceId	Obtient l’identificateur de l’appareil.
DisplayAdapterDeviceId	Obtient l’identificateur de l’appareil de l’adaptateur d’affichage auquel le moniteur est connecté. Notez que l’adaptateur d’affichage n’est peut-être pas l’appareil le plus approprié pour le rendu.
DisplayAdapterId	Obtient l’identificateur unique local (LUID) de l’adaptateur d’affichage auquel le moniteur est connecté. Notez que l’adaptateur d’affichage auquel le moniteur est connecté n’est peut-être pas le plus approprié pour le rendu. Un LUID est une valeur 64 bits garantie pour être unique uniquement sur le système sur lequel elle a été générée. Le caractère unique d’un LUID n’est garanti que jusqu’à ce que le système soit redémarré. Ce LUID est compatible avec les API Direct3D, DisplayConfig et HolographicSpace .
DisplayAdapterTargetId	Obtient un ID opaque utilisé par l’adaptateur d’affichage pour identifier le connecteur auquel le moniteur est attaché. Cet ID cible peut être utilisé avec les API DisplayConfig .
DisplayName	Obtient un nom convivial pour l’appareil adapté à l’affichage d’un utilisateur.
GreenPrimary	Obtient le point primaire vert de chromaticité (calculé à partir des données d’identification d’affichage étendue ou EDID du moniteur et des remplacements de pilote).
IsDolbyVisionSupportedInHdrMode	Obtient une valeur qui indique si les métadonnées du moniteur ont spécifié qu’il traite la plage dynamique élevée (HDR) comme un mode Dolby Vision spécial. Cette API est destinée à être utilisée par le décodeur vidéo DolbyVision s’exécutant dans le média pour lire du contenu spécialement certifié.
MaxAverageFullFrameLuminanceInNits	Obtient la luminosité moyenne moyenne maximale de l’écran dans les lentes.
MaxLuminanceInNits	Obtient la luminance maximale du moniteur dans les lentes.
MinLuminanceInNits	Obtient la luminance minimale du moniteur dans les lentes.
NativeResolutionInRawPixels	Obtient la résolution native du moniteur en pixels bruts.
PhysicalConnector	Obtient une valeur représentant la norme de connecteur physique utilisée pour connecter l’affichage.
PhysicalSizeInInches	Obtient la taille de diagonale physique du moniteur en pouces.
RawDpiX	Obtient le DPI horizontal physique du moniteur (en fonction de la résolution native et de la taille physique du moniteur).
RawDpiY	Obtient le DPI vertical physique du moniteur (en fonction de la résolution native et de la taille physique du moniteur).
RedPrimary	Obtient le point principal rouge de chromaticité (calculé à partir des données d’identification de l’affichage étendu du moniteur ou EDID, et tous les remplacements de pilote).
UsageKind	Obtient une valeur représentant l’utilisation à laquelle l’affichage est placé.
WhitePoint	Obtient le point blanc de chromaticité (calculé à partir des données d’identification d’affichage étendu ou EDID de l’écran et des remplacements de pilote).

Méthodes

FromIdAsync(String)	Crée de manière asynchrone un objet DisplayMonitor pour l’identificateur d’appareil spécifié (chaîne contenant un chemin d’accès instance périphérique PnP). Consultez l’exemple de code ci-dessous. Notes L’argument doit être un identificateur d’appareil et non un identificateur d’interface d’appareil. Si vous avez un identificateur d’interface d’appareil (ce qui est probable), appelez Plutôt FromInterfaceIdAsync . Pour plus d’informations, consultez DeviceInformation.Id.
FromInterfaceIdAsync(String)	Crée de manière asynchrone un objet DisplayMonitor pour l’identificateur d’interface du moniteur spécifié (chaîne contenant un chemin d’interface d’appareil PnP). Consultez l’exemple de code ci-dessous. Notes Si vous appelez DeviceInformation.FindAllAsync, en passant la chaîne de sélecteur d’interface d’appareil AQS (Advanced Query Syntax) retournée par DisplayMonitor.GetDeviceSelector, vous récupérerez une collection d’objets DeviceInformation qui décrivent des interfaces de surveillance (plutôt que des appareils de surveillance). L’accès à la propriété DeviceInformation.Id sur l’un de ces objets récupère un identificateur d’interface de moniteur, que vous pouvez passer à DisplayMonitor.FromInterfaceIdAsync. Consultez l’exemple de code ci-dessous. La plupart des API Win32 qui fournissent un identificateur de moniteur fournissent en fait l’identificateur d’interface du moniteur (et non l’identificateur d’appareil).
GetDescriptor(DisplayMonitorDescriptorKind)	Récupère un descripteur matériel du type spécifié.
GetDeviceSelector()	Retourne une chaîne de sélecteur d’interface d’appareil AQS (Advanced Query Syntax) dans le but de récupérer des interfaces d’appareil (plutôt que des appareils). Le sélecteur peut être utilisé par DeviceInformation.CreateWatcher pour watch et énumérer les appareils de surveillance sur le système. Vous pouvez également l’utiliser avec DeviceInformation.FindAllAsync pour récupérer une collection d’objets DeviceInformation qui décrivent des interfaces de surveillance (plutôt que des appareils de surveillance). L’accès à la propriété DeviceInformation.Id sur l’un de ces objets récupère un identificateur d’interface de moniteur que vous pouvez passer à DisplayMonitor.FromInterfaceIdAsync (pour plus d’informations, consultez l’exemple de code pour DisplayMonitor.FromInterfaceIdAsync). Si vous demandez la propriété supplémentaire System.Devices.DeviceInstanceId à findAllAsync, vous pouvez appeler DisplayMonitor.FromIdAsync (pour plus d’informations, consultez l’exemple de code pour DisplayMonitor.FromIdAsync).