Share via


DisplayMonitor Kelas

Definisi

Menyediakan informasi tentang perangkat monitor tampilan yang tersambung ke sistem.

Data ini mencakup informasi yang umum digunakan dari Extended Display Identification Data (EDID) monitor, yang merupakan blok deskriptor tampilan standar industri yang hampir semua monitor gunakan untuk memberikan deskripsi mode yang didukung dan informasi perangkat umum) dan DisplayID (yang merupakan standar industri yang lebih baru yang menyediakan superset 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
Warisan
Object Platform::Object IInspectable DisplayMonitor
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10, version 1803 (diperkenalkan dalam 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v6.0)

Keterangan

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
2004 19041 IsDolbyVisionSupportedInHdrMode

Properti

BluePrimary

Mendapatkan titik primer biru kromatikitas (dihitung dari Data Identifikasi Tampilan Diperluas monitor, atau EDID, dan penimpaan driver apa pun).

ConnectionKind

Mendapatkan nilai yang mewakili metode abstrak di mana tampilan terhubung (tidak spesifik untuk protokol fisik).

DeviceId

Mendapatkan pengidentifikasi perangkat.

DisplayAdapterDeviceId

Mendapatkan pengidentifikasi perangkat adaptor tampilan tempat monitor tersambung. Perhatikan bahwa adaptor tampilan mungkin bukan perangkat yang paling cocok untuk penyajian.

DisplayAdapterId

Mendapatkan pengidentifikasi unik lokal (LUID) dari adaptor tampilan tempat monitor tersambung. Perhatikan bahwa adaptor tampilan yang terhubung dengan monitor mungkin bukan yang paling cocok untuk penyajian.

LUID adalah nilai 64-bit yang dijamin unik hanya pada sistem tempatnya dihasilkan. Keunikan LUID dijamin hanya sampai sistem dimulai ulang. LUID ini kompatibel dengan API Direct3D, DisplayConfig, dan HolographicSpace .

DisplayAdapterTargetId

Mendapatkan ID buram yang digunakan oleh adaptor tampilan untuk mengidentifikasi konektor mana yang dilampirkan monitor. ID target ini dapat digunakan dengan API DisplayConfig .

DisplayName

Mendapatkan nama yang mudah diingat untuk perangkat yang cocok untuk ditampilkan kepada pengguna.

GreenPrimary

Mendapatkan titik primer hijau kromatikitas (dihitung dari Data Identifikasi Tampilan Diperluas monitor, atau EDID, dan penimpaan driver apa pun).

IsDolbyVisionSupportedInHdrMode

Mendapatkan nilai yang menunjukkan apakah metadata monitor telah menentukan bahwa ia memperlakukan rentang dinamis tinggi (HDR) sebagai mode Dolby Vision khusus. API ini dimaksudkan untuk digunakan oleh dekoder video DolbyVision yang berjalan dalam media untuk memutar konten bersertifikat khusus.

MaxAverageFullFrameLuminanceInNits

Mendapatkan luminans bingkai penuh rata-rata maksimum monitor dalam nits.

MaxLuminanceInNits

Mendapatkan luminance maksimum monitor dalam nits.

MinLuminanceInNits

Mendapatkan luminance minimum monitor dalam nits.

NativeResolutionInRawPixels

Mendapatkan resolusi asli monitor dalam piksel mentah.

PhysicalConnector

Mendapatkan nilai yang mewakili standar konektor fisik yang digunakan untuk menyambungkan layar.

PhysicalSizeInInches

Mendapatkan ukuran diagonal fisik monitor dalam inci.

RawDpiX

Mendapatkan DPI horizontal fisik monitor (berdasarkan resolusi asli monitor dan ukuran fisik).

RawDpiY

Mendapatkan DPI vertikal fisik monitor (berdasarkan resolusi asli monitor dan ukuran fisik).

RedPrimary

Mendapatkan titik primer merah kromatikitas (dihitung dari Data Identifikasi Tampilan Diperluas monitor, atau EDID, dan penimpaan driver apa pun).

UsageKind

Mendapatkan nilai yang mewakili penggunaan tempat tampilan sedang diletakkan.

WhitePoint

Mendapatkan titik putih kromatikitas (dihitung dari Data Identifikasi Tampilan Diperluas monitor, atau EDID, dan penimpaan driver apa pun).

Metode

FromIdAsync(String)

Secara asinkron membuat objek DisplayMonitor untuk pengidentifikasi perangkat yang ditentukan (string yang berisi jalur instans perangkat PnP). Lihat contoh kode di bawah ini.

Catatan

Argumen harus berupa pengidentifikasi perangkat, dan bukan pengidentifikasi antarmuka perangkat. Jika Anda memiliki pengidentifikasi antarmuka perangkat (kemungkinan besar), maka panggil FromInterfaceIdAsync sebagai gantinya. Untuk detail selengkapnya, lihat DeviceInformation.Id.

FromInterfaceIdAsync(String)

Secara asinkron membuat objek DisplayMonitor untuk pengidentifikasi antarmuka monitor yang ditentukan (string yang berisi jalur antarmuka perangkat PnP). Lihat contoh kode di bawah ini.

Catatan

Jika Anda memanggil DeviceInformation.FindAllAsync, melewati string pemilih antarmuka perangkat Advanced Query Syntax (AQS) yang dikembalikan oleh DisplayMonitor.GetDeviceSelector, maka Anda akan mengambil kumpulan objek DeviceInformation yang menjelaskan antarmuka monitor (bukan perangkat monitor). Mengakses properti DeviceInformation.Id pada salah satu objek tersebut mengambil pengidentifikasi antarmuka monitor, yang dapat Anda teruskan ke DisplayMonitor.FromInterfaceIdAsync. Lihat contoh kode di bawah ini.

Sebagian besar API Win32 yang menyediakan pengidentifikasi monitor benar-benar menyediakan pengidentifikasi antarmuka monitor (dan bukan pengidentifikasi perangkat).

GetDescriptor(DisplayMonitorDescriptorKind)

Mengambil pendeskripsi perangkat keras dari jenis yang ditentukan.

GetDeviceSelector()

Mengembalikan string pemilih antarmuka perangkat Advanced Query Syntax (AQS) untuk tujuan mengambil antarmuka perangkat (bukan perangkat).

Pemilih dapat digunakan oleh DeviceInformation.CreateWatcher untuk watch dan menghitung perangkat monitor pada sistem. Atau dapat digunakan dengan DeviceInformation.FindAllAsync untuk mengambil kumpulan objek DeviceInformation yang menjelaskan antarmuka monitor (bukan memantau perangkat). Mengakses properti DeviceInformation.Id pada salah satu objek tersebut mengambil pengidentifikasi antarmuka monitor, yang dapat Anda teruskan ke DisplayMonitor.FromInterfaceIdAsync (untuk detailnya, lihat contoh kode untuk DisplayMonitor.FromInterfaceIdAsync). Jika Anda meminta properti tambahan System.Devices.DeviceInstanceId dari FindAllAsync, maka Anda dapat memanggil DisplayMonitor.FromIdAsync (untuk detailnya, lihat contoh kode untuk DisplayMonitor.FromIdAsync).

Berlaku untuk