DisplayMonitor 類別

定義

命名空間:

Windows.Devices.Display

提供連接至系統之顯示器監視器裝置的相關資訊。

這些資料包括來自監視器擴充顯示識別資料 (EDID 的常用資訊，這是業界標準的顯示描述元區塊，幾乎所有監視器都會用來提供支援模式的描述和一般裝置資訊) 和 DisplayID (，這是提供 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

繼承

Object Platform::Object IInspectable DisplayMonitor

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10, version 1803 (已於 10.0.17134.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v6.0 引進)

備註

版本歷程記錄

Windows 版本	SDK 版本	已新增值
2004	19041	IsDolbyVisionSupportedInHdrMode

屬性

BluePrimary	取得從監視器的擴充顯示識別資料或 EDID 計算 (的藍色主要點，而任何驅動程式都會覆寫) 。
ConnectionKind	取得值，表示顯示與實體通訊協定) 不特定的連接 (抽象方法。
DeviceId	取得裝置識別碼。
DisplayAdapterDeviceId	取得監視器所連接之顯示介面卡的裝置識別碼。 請注意，顯示介面卡可能不是最適合轉譯的裝置。
DisplayAdapterId	取得本機唯一識別碼 (LUID) 監視所連接的顯示介面卡。 請注意，監視器所連接的顯示介面卡可能不適合轉譯。 LUID 是 64 位值，保證只在產生的系統上是唯一的。 只有在重新開機系統之前，才會保證 LUID 的唯一性。 此 LUID 與 Direct3D、 DisplayConfig和 HolographicSpace API 相容。
DisplayAdapterTargetId	取得顯示配接器用來識別監視器所連接的連接器不透明識別碼。 此目標識別碼可以搭配 DisplayConfig API 使用。
DisplayName	取得適合向使用者顯示之裝置的易記名稱。
GreenPrimary	取得從監視器的擴充顯示識別資料或 EDID 計算 (綠色主要點，而任何驅動程式都會覆寫) 。
IsDolbyVisionSupportedInHdrMode	取得值，指出監視器的中繼資料是否已指定它將高動態範圍 (HDR) 視為特殊 Dolby 視覺 模式。 此 API 旨在供媒體內執行的 DolbyVision 影片解碼器用來播放特別認證的內容。
MaxAverageFullFrameLuminanceInNits	取得監視器在 nits 中的最大平均全畫面亮度。
MaxLuminanceInNits	取得監視器在 nits 中的最大亮度。
MinLuminanceInNits	取得監視器在 nits 中的最小亮度。
NativeResolutionInRawPixels	取得監視器的原始解析度，以原始圖元為單位。
PhysicalConnector	取得值，表示用來連接顯示器的實體連接器標準。
PhysicalSizeInInches	取得監視器的實體對角線大小，以英吋為單位。
RawDpiX	根據監視器的原生解析度和實體大小) ，取得監視器的實體水準 DPI (。
RawDpiY	根據監視器的原生解析度和實體大小) ，取得監視器的實體垂直 DPI (。
RedPrimary	取得從監視器的擴充顯示識別資料或 EDID 計算 (的色度紅色主要點，而任何驅動程式都會覆寫) 。
UsageKind	取得值，表示要放置顯示之用途的值。
WhitePoint	取得從監視器的擴充顯示識別資料或 EDID 計算 (的白點，而任何驅動程式都會覆寫) 。

方法

FromIdAsync(String)	以非同步方式為指定的裝置識別碼建立 DisplayMonitor 物件， (包含 PnP 裝置實例路徑的字串) 。 請參閱下列程式碼範例。 注意 引數必須是裝置識別碼，而不是裝置介面識別碼。 如果您有可能) 的裝置介面識別碼 (，請改為呼叫 FromInterfaceIdAsync 。 如需詳細資訊，請參閱 DeviceInformation.Id。
FromInterfaceIdAsync(String)	以非同步方式為指定的監視介面識別碼建立 DisplayMonitor 物件， (包含 PnP 裝置介面路徑的字串) 。 請參閱下列程式碼範例。 注意 如果您呼叫 DeviceInformation.FindAllAsync，傳遞進階查詢語法 (AQS) DisplayMonitor.GetDeviceSelector所傳回的裝置介面選取器字串，則您將會擷取描述監視介面的 DeviceInformation 物件集合 (，而不是監視裝置) 。 存取其中一個物件上的 DeviceInformation.Id 屬性會擷取監視介面識別碼，您可以傳遞至 DisplayMonitor.FromInterfaceIdAsync。 請參閱下列程式碼範例。 大部分提供監視識別碼的 WIN32 API 實際上會提供監視介面識別碼 (，而不是裝置識別碼) 。
GetDescriptor(DisplayMonitorDescriptorKind)	擷取指定之種類的硬體描述元。
GetDeviceSelector()	傳回進階查詢語法 (AQS) 裝置介面選取器字串，以便擷取裝置 介面 (而非裝置) 。 DeviceInformation.CreateWatcher可以使用選取器來watch並列舉系統上的監視裝置。 或者，它可與 DeviceInformation.FindAllAsync 搭配使用，以擷取描述監視介面 (的 DeviceInformation 物件集合，而不是監視裝置) 。 存取其中一個物件上的 DeviceInformation.Id 屬性會擷取監視介面識別碼，您可以傳遞至 DisplayMonitor.FromInterfaceIdAsync (以取得詳細資料，請參閱 DisplayMonitor.FromInterfaceIdAsync) 的程式碼範例。 如果您從 FindAllAsync要求 System.Devices.DeviceInstanceId 其他屬性，則可以呼叫 DisplayMonitor.FromIdAsync (以取得詳細資料，請參閱 DisplayMonitor.FromIdAsync) 的程式碼範例。