DisplayMonitor Klasse

Referenz

Definition

Namespace:: Windows.Devices.Display

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt Informationen zu einem Anzeigemonitorgerät bereit, das mit dem System verbunden ist.

Zu diesen Daten gehören häufig verwendete Informationen aus den Erweiterten Anzeigeidentifikationsdaten (EDID, einem branchenüblichen Anzeigedeskriptorblock, den fast alle Monitore verwenden, um Beschreibungen der unterstützten Modi und allgemeinen Geräteinformationen bereitzustellen) und DisplayID (ein neuerer Industriestandard, der eine Obermenge von EDID bereitstellt).

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

Vererbung: Object Platform::Object IInspectable DisplayMonitor

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v6.0)

Hinweise

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
2004	19041	IsDolbyVisionSupportedInHdrMode

Eigenschaften

BluePrimary	Ruft den blauen Farbpunkt (berechnet aus den erweiterten Anzeigeidentifikationsdaten des Monitors oder EDID) und allen Treiberüberschreibungen ab.
ConnectionKind	Ruft einen Wert ab, der die abstrakte Methode darstellt, in der die Anzeige verbunden ist (nicht spezifisch für ein physisches Protokoll).
DeviceId	Ruft den Gerätebezeichner ab.
DisplayAdapterDeviceId	Ruft den Gerätebezeichner der Grafikkarte ab, mit der der Monitor verbunden ist. Beachten Sie, dass die Grafikkarte möglicherweise nicht das am besten geeignete Gerät für das Rendern ist.
DisplayAdapterId	Ruft den lokal eindeutigen Bezeichner (LUID) des Grafikkartes ab, mit dem der Monitor verbunden ist. Beachten Sie, dass die Grafikkarte, mit der der Monitor verbunden ist, möglicherweise nicht die beste Für das Rendern ist. Eine LUID ist ein 64-Bit-Wert, der garantiert nur auf dem System eindeutig ist, auf dem er generiert wurde. Die Eindeutigkeit einer LUID wird nur garantiert, bis das System neu gestartet wird. Diese LUID ist mit Direct3D-, DisplayConfig- und HolographicSpace-APIs kompatibel.
DisplayAdapterTargetId	Ruft eine undurchsichtige ID ab, die vom Grafikkarte verwendet wird, um zu identifizieren, an welchen Connector der Monitor angefügt ist. Diese Ziel-ID kann mit DisplayConfig-APIs verwendet werden.
DisplayName	Ruft einen Anzeigenamen für das Gerät ab, das für die Anzeige für einen Benutzer geeignet ist.
GreenPrimary	Ruft den grünen Primärpunkt (berechnet aus den erweiterten Anzeigeidentifikationsdaten des Monitors oder EDID) und allen Treiberüberschreibungen ab.
IsDolbyVisionSupportedInHdrMode	Ruft einen Wert ab, der angibt, ob die Metadaten des Monitors angegeben haben, dass high dynamic range (HDR) als spezieller Dolby Vision-Modus behandelt wird. Diese API soll vom DolbyVision-Videodecoder verwendet werden, der innerhalb von Medien ausgeführt wird, um speziell zertifizierte Inhalte wiederzugeben.
MaxAverageFullFrameLuminanceInNits	Ruft die maximale durchschnittliche Vollbildleuchtigkeit des Monitors in Nissen ab.
MaxLuminanceInNits	Ruft die maximale Leuchtdichte des Monitors in Nissen ab.
MinLuminanceInNits	Ruft die minimale Leuchtdichte des Monitors in Nissen ab.
NativeResolutionInRawPixels	Ruft die native Auflösung des Monitors in unformatierten Pixeln ab.
PhysicalConnector	Ruft einen Wert ab, der den physischen Connectorstandard darstellt, der zum Verbinden der Anzeige verwendet wird.
PhysicalSizeInInches	Ruft die physische Diagonale des Monitors in Zoll ab.
RawDpiX	Ruft den physischen horizontalen DPI-Wert des Monitors ab (basierend auf der nativen Auflösung und der physischen Größe des Monitors).
RawDpiY	Ruft den physischen vertikalen DPI-Wert des Monitors ab (basierend auf der nativen Auflösung und der physischen Größe des Monitors).
RedPrimary	Ruft den roten Farbpunkt (berechnet aus den erweiterten Anzeigeidentifikationsdaten des Monitors oder EDID) und allen Treiberüberschreibungen ab.
UsageKind	Ruft einen Wert ab, der die Verwendung der Anzeige darstellt.
WhitePoint	Ruft den Weißpunkt der Chromatik (berechnet aus den erweiterten Anzeigeidentifikationsdaten des Monitors oder EDID und allen Treiberüberschreibungen) ab.

Methoden

FromIdAsync(String)	Erstellt asynchron ein DisplayMonitor-Objekt für den angegebenen Gerätebezeichner (eine Zeichenfolge, die ein PnP-Gerät instance Pfad enthält). Sehen Sie sich das Codebeispiel unten an. Hinweis Das Argument muss ein Gerätebezeichner und kein Geräteschnittstellenbezeichner sein. Wenn Sie über einen Geräteschnittstellenbezeichner verfügen (was wahrscheinlich ist), rufen Sie stattdessen FromInterfaceIdAsync auf. Weitere Informationen finden Sie unter DeviceInformation.Id.
FromInterfaceIdAsync(String)	Erstellt asynchron ein DisplayMonitor-Objekt für den angegebenen Monitorschnittstellenbezeichner (eine Zeichenfolge, die einen PnP-Geräteschnittstellenpfad enthält). Sehen Sie sich das Codebeispiel unten an. Hinweis Wenn Sie DeviceInformation.FindAllAsync aufrufen und dabei die AQS-Geräteschnittstellenauswahlzeichenfolge (Advanced Query Syntax) übergeben, die von DisplayMonitor.GetDeviceSelector zurückgegeben wird, rufen Sie eine Sammlung von DeviceInformation-Objekten ab, die Überwachungsschnittstellen beschreiben (anstatt Geräte zu überwachen). Beim Zugriff auf die DeviceInformation.Id-Eigenschaft für eines dieser Objekte wird ein Bezeichner der Monitorschnittstelle abgerufen, den Sie an DisplayMonitor.FromInterfaceIdAsync übergeben können. Sehen Sie sich das Codebeispiel unten an. Die meisten Win32-APIs, die einen Monitorbezeichner bereitstellen, stellen tatsächlich den Monitorschnittstellenbezeichner (und nicht den Gerätebezeichner) bereit.
GetDescriptor(DisplayMonitorDescriptorKind)	Ruft einen Hardwaredeskriptor der angegebenen Art ab.
GetDeviceSelector()	Gibt eine AQS-Geräteschnittstellenauswahlzeichenfolge (Advanced Query Syntax) zurück, die zum Abrufen von Geräteschnittstellen (anstelle von Geräten) dient. Der Selektor kann von DeviceInformation.CreateWatcher verwendet werden, um Überwachungsgeräte auf dem System zu watch und aufzulisten. Oder es kann mit DeviceInformation.FindAllAsync verwendet werden, um eine Sammlung von DeviceInformation-Objekten abzurufen, die Monitorschnittstellen beschreiben (anstatt Geräte zu überwachen). Durch den Zugriff auf die DeviceInformation.Id-Eigenschaft für eines dieser Objekte wird ein Monitorschnittstellenbezeichner abgerufen, den Sie an DisplayMonitor.FromInterfaceIdAsync übergeben können (weitere Informationen finden Sie im Codebeispiel für DisplayMonitor.FromInterfaceIdAsync). Wenn Sie die zusätzliche System.Devices.DeviceInstanceId-Eigenschaft von FindAllAsync anfordern, können Sie DisplayMonitor.FromIdAsync aufrufen (weitere Informationen finden Sie im Codebeispiel für DisplayMonitor.FromIdAsync).

Gilt für:

Freigeben über