DisplayMonitor Класс

Определение

Предоставляет сведения об устройстве монитора дисплея, подключенном к системе.

Эти данные включают часто используемую информацию из расширенных данных идентификации дисплея монитора (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
Атрибуты

Требования к 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 совместим с API Direct3D, DisplayConfig и HolographicSpace .

DisplayAdapterTargetId

Возвращает непрозрачный идентификатор, используемый адаптером дисплея для определения соединителя, к которому подключен монитор. Этот целевой идентификатор можно использовать с API DisplayConfig .

DisplayName

Возвращает понятное имя устройства, подходящее для отображения пользователю.

GreenPrimary

Возвращает основную зеленую точку цветности (вычисляется на основе расширенных идентификационных данных монитора или EDID и любых переопределений драйверов).

IsDolbyVisionSupportedInHdrMode

Возвращает значение, указывающее, указано ли в метаданных монитора, что он обрабатывает высокий динамический диапазон (HDR) как специальный режим Визуального распознавания Dolby . Этот API предназначен для использования видеодекодером DolbyVision, работающим на носителе, для воспроизведения специально сертифицированного содержимого.

MaxAverageFullFrameLuminanceInNits

Возвращает максимальную среднюю полнокадровую яркость монитора в нитах.

MaxLuminanceInNits

Возвращает максимальную яркость монитора в нитах.

MinLuminanceInNits

Возвращает минимальную яркость монитора в нитах.

NativeResolutionInRawPixels

Возвращает собственное разрешение монитора в необработанных пикселях.

PhysicalConnector

Возвращает значение, представляющее физический стандарт соединителя, используемый для подключения дисплея.

PhysicalSizeInInches

Возвращает физический размер монитора по диагонали в дюймах.

RawDpiX

Возвращает физическое горизонтальное разрешение монитора (на основе собственного разрешения и физического размера монитора).

RawDpiY

Возвращает физический вертикальный DPI монитора (на основе собственного разрешения и физического размера монитора).

RedPrimary

Возвращает основную точку цвета цветности (вычисляется на основе расширенных идентификационных данных монитора или EDID и любых переопределений драйверов).

UsageKind

Возвращает значение, представляющее использование, в которое помещается дисплей.

WhitePoint

Возвращает белую точку цветности (вычисленную на основе расширенных данных идентификации дисплея монитора или EDID, а также любых переопределений драйверов).

Методы

FromIdAsync(String)

Асинхронно создает объект DisplayMonitor для указанного идентификатора устройства (строка, содержащая путь к экземпляру устройства PnP). См. пример кода ниже.

Примечание

Аргумент должен быть идентификатором устройства, а не идентификатором интерфейса устройства. Если у вас есть идентификатор интерфейса устройства (что скорее всего), вызовите вместо него метод FromInterfaceIdAsync . Дополнительные сведения см. в разделе DeviceInformation.Id.

FromInterfaceIdAsync(String)

Асинхронно создает объект DisplayMonitor для указанного идентификатора интерфейса монитора (строка, содержащая путь к интерфейсу устройства PnP). См. пример кода ниже.

Примечание

Если вызвать DeviceInformation.FindAllAsync, передав строку селектора интерфейса устройства Advanced Query Syntax (AQS), возвращенную DisplayMonitor.GetDeviceSelector, вы получите коллекцию объектов DeviceInformation , описывающих интерфейсы мониторинга (а не устройства мониторинга). При доступе к свойству DeviceInformation.Id одного из этих объектов извлекается идентификатор интерфейса монитора, который можно передать в DisplayMonitor.FromInterfaceIdAsync. См. пример кода ниже.

Большинство API Win32, которые предоставляют идентификатор монитора, фактически предоставляют идентификатор интерфейса монитора (а не идентификатор устройства).

GetDescriptor(DisplayMonitorDescriptorKind)

Извлекает дескриптор оборудования указанного типа.

GetDeviceSelector()

Возвращает строку селектора интерфейса устройства расширенного синтаксиса запросов (AQS) для получения интерфейсов устройств (а не устройств).

Селектор может использоваться DeviceInformation.CreateWatcher для watch и перечисления устройств мониторинга в системе. Или его можно использовать с DeviceInformation.FindAllAsync для получения коллекции объектов DeviceInformation , описывающих интерфейсы мониторинга (а не устройства мониторинга). При доступе к свойству DeviceInformation.Id одного из этих объектов извлекается идентификатор интерфейса монитора, который можно передать в DisplayMonitor.FromInterfaceIdAsync (дополнительные сведения см. в примере кода для DisplayMonitor.FromInterfaceIdAsync). При запросе дополнительного свойства System.Devices.DeviceInstanceId из FindAllAsync можно вызвать DisplayMonitor.FromIdAsync (дополнительные сведения см. в примере кода для DisplayMonitor.FromIdAsync).

Применяется к