DisplayMonitor Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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). |