Partager via


DisplayMonitor Classe

Définition

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

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).

S’applique à