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	모니터가 연결된 커넥터를 식별하기 위해 디스플레이 어댑터에서 사용하는 불투명 ID를 가져옵니다. 이 대상 ID는 DisplayConfig API 와 함께 사용할 수 있습니다.
DisplayName	사용자에게 표시하기에 적합한 디바이스의 이름을 가져옵니다.
GreenPrimary	모니터의 확장 디스플레이 식별 데이터 또는 EDID 및 모든 드라이버 재정의에서 계산된 색도 녹색 기본 지점을 가져옵니다.
IsDolbyVisionSupportedInHdrMode	모니터의 메타데이터가 HDR(High Dynamic Range)을 특수 Dolby Vision 모드로 처리한다고 지정했는지 여부를 나타내는 값을 가져옵니다. 이 API는 미디어 내에서 실행되는 DolbyVision 비디오 디코더가 특별히 인증된 콘텐츠를 재생하는 데 사용됩니다.
MaxAverageFullFrameLuminanceInNits	모니터의 최대 평균 풀 프레임 광도(nits)를 가져옵니다.
MaxLuminanceInNits	모니터의 최대 광도(nits)를 가져옵니다.
MinLuminanceInNits	모니터의 최소 광도(nits)를 가져옵니다.
NativeResolutionInRawPixels	원시 픽셀에서 모니터의 네이티브 해상도를 가져옵니다.
PhysicalConnector	디스플레이를 연결하는 데 사용되는 물리적 커넥터 표준을 나타내는 값을 가져옵니다.
PhysicalSizeInInches	모니터의 물리적 대각선 크기를 인치 단위로 가져옵니다.
RawDpiX	모니터의 기본 해상도 및 물리적 크기에 따라 모니터의 물리적 가로 DPI를 가져옵니다.
RawDpiY	모니터의 기본 해상도 및 물리적 크기에 따라 모니터의 물리적 세로 DPI를 가져옵니다.
RedPrimary	색이 빨간색 기본 지점을 가져옵니다(모니터의 확장 디스플레이 식별 데이터 또는 EDID 및 모든 드라이버 재정의에서 계산됨).
UsageKind	디스플레이가 배치되는 용도를 나타내는 값을 가져옵니다.
WhitePoint	색도 흰색 점을 가져옵니다(모니터의 확장 디스플레이 식별 데이터 또는 EDID 및 모든 드라이버 재정의에서 계산됨).

메서드

FromIdAsync(String)	지정된 디바이스 식별자(PnP 디바이스 instance 경로를 포함하는 문자열)에 대한 DisplayMonitor 개체를 비동기적으로 만듭니다. 아래 코드 예제를 참조하세요. 참고 인수는 디바이스 인터페이스 식별자가 아닌 디바이스 식별자여야 합니다. 디바이스 인터페이스 식별자(가능성이 높음)가 있는 경우 FromInterfaceIdAsync 를 대신 호출합니다. 자세한 내용은 DeviceInformation.Id.
FromInterfaceIdAsync(String)	지정된 모니터 인터페이스 식별자(PnP 디바이스 인터페이스 경로를 포함하는 문자열)에 대한 DisplayMonitor 개체를 비동기적으로 만듭니다. 아래 코드 예제를 참조하세요. 참고 DeviceInformation.FindAllAsync를 호출하여 DisplayMonitor.GetDeviceSelector에서 반환된 AQS(고급 쿼리 구문) 디바이스 인터페이스 선택기 문자열을 전달하는 경우 모니터 디바이스가 아닌 모니터 인터페이스를 설명하는 DeviceInformation 개체의 컬렉션을 검색합니다. 이러한 개체 중 하나에서 DeviceInformation.Id 속성에 액세스하면 DisplayMonitor.FromInterfaceIdAsync에 전달할 수 있는 모니터 인터페이스 식별자가 검색됩니다. 아래 코드 예제를 참조하세요. 모니터 식별자를 제공하는 대부분의 Win32 API는 실제로 디바이스 식별자가 아닌 모니터 인터페이스 식별자를 제공합니다.
GetDescriptor(DisplayMonitorDescriptorKind)	지정된 종류의 하드웨어 설명자를 검색합니다.
GetDeviceSelector()	디바이스가 아닌 디바이스 인터페이스를 검색하기 위한 AQS(고급 쿼리 구문) 디바이스 인터페이스 선택기 문자열을 반환 합니다 . DeviceInformation.CreateWatcher에서 선택기를 사용하여 시스템에서 모니터 디바이스를 watch 열거할 수 있습니다. 또는 DeviceInformation.FindAllAsync 와 함께 사용하여 모니터 디바이스가 아닌 모니터 인터페이스를 설명하는 DeviceInformation 개체의 컬렉션을 검색할 수 있습니다. 이러한 개체 중 하나에서 DeviceInformation.Id 속성에 액세스하면 Monitor 인터페이스 식별자를 검색합니다. 이 식별자를 DisplayMonitor.FromInterfaceIdAsync 에 전달할 수 있습니다(자세한 내용은 DisplayMonitor.FromInterfaceIdAsync의 코드 예제 참조). FindAllAsync에서 System.Devices.DeviceInstanceId 추가 속성을 요청하는 경우 DisplayMonitor.FromIdAsync를 호출할 수 있습니다(자세한 내용은 DisplayMonitor.FromIdAsync의 코드 예제 참조).