Condividi tramite


DisplayMonitor Classe

Definizione

Fornisce informazioni su un dispositivo di monitoraggio visualizzato connesso al sistema.

Questi dati includono informazioni comunemente usate dai dati di identificazione di visualizzazione estesa del monitoraggio (EDID, ovvero un descrittore di visualizzazione standard del settore che quasi tutti i monitoraggi usano per fornire descrizioni delle modalità supportate e delle informazioni generali sul dispositivo) e DisplayID (che è un nuovo standard di settore che fornisce un superset di 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
Ereditarietà
Object Platform::Object IInspectable DisplayMonitor
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)

Commenti

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
2004 19041 IsDolbyVisionSupportedInHdrMode

Proprietà

BluePrimary

Ottiene il punto primario blu cromatico (calcolato dai dati di identificazione di visualizzazione estesi del monitor o EDID e qualsiasi override del driver).

ConnectionKind

Ottiene un valore che rappresenta il metodo astratto in cui la visualizzazione è connessa (non specifica di un protocollo fisico).

DeviceId

Ottiene l'identificatore del dispositivo.

DisplayAdapterDeviceId

Ottiene l'identificatore del dispositivo dell'adattatore di visualizzazione a cui è connesso il monitoraggio. Si noti che l'adattatore di visualizzazione potrebbe non essere il dispositivo più adatto per il rendering.

DisplayAdapterId

Ottiene l'identificatore univoco locale (LUID) della scheda di visualizzazione a cui è connesso il monitoraggio. Si noti che la scheda di visualizzazione a cui è connesso il monitor potrebbe non essere quella più adatta per il rendering.

Un LUID è un valore a 64 bit garantito essere univoco solo nel sistema in cui è stato generato. L'univocità di un LUID è garantita solo fino al riavvio del sistema. Questo LUID è compatibile con le API Direct3D, DisplayConfig e HolographicSpace .

DisplayAdapterTargetId

Ottiene un ID opaco utilizzato dall'adattatore di visualizzazione per identificare il connettore a cui è collegato il monitor. Questo ID di destinazione può essere usato con le API DisplayConfig .

DisplayName

Ottiene un nome descrittivo per il dispositivo adatto per la visualizzazione a un utente.

GreenPrimary

Ottiene il punto primario verde cromatico (calcolato dai dati di identificazione di visualizzazione estesa del monitor o EDID) e da qualsiasi override del driver.

IsDolbyVisionSupportedInHdrMode

Ottiene un valore che indica se i metadati del monitor hanno specificato che tratta l'intervallo dinamico elevato (HDR) come una modalità Dolby Vision speciale. Questa API deve essere usata dal decodificatore video DolbyVision in esecuzione all'interno dei supporti per riprodurre contenuti appositamente certificati.

MaxAverageFullFrameLuminanceInNits

Ottiene la luminanza media massima del fotogramma intero del monitor in nits.

MaxLuminanceInNits

Ottiene la luminanza massima del monitoraggio in nits.

MinLuminanceInNits

Ottiene la luminanza minima del monitor in nits.

NativeResolutionInRawPixels

Ottiene la risoluzione nativa del monitoraggio in pixel non elaborati.

PhysicalConnector

Ottiene un valore che rappresenta lo standard del connettore fisico usato per connettere la visualizzazione.

PhysicalSizeInInches

Ottiene le dimensioni diagonali fisiche del monitor in pollici.

RawDpiX

Ottiene la DPI orizzontale fisica del monitoraggio (in base alla risoluzione nativa del monitoraggio e alle dimensioni fisiche).

RawDpiY

Ottiene la DPI verticale fisica del monitor (in base alla risoluzione nativa del monitoraggio e alle dimensioni fisiche).

RedPrimary

Ottiene il punto primario rosso di cromaticità (calcolato dai dati di identificazione di visualizzazione estesa del monitoraggio o EDID) e da qualsiasi override del driver.

UsageKind

Ottiene un valore che rappresenta l'uso in cui viene inserito il display.

WhitePoint

Ottiene il punto bianco di cromaticità (calcolato dai dati di identificazione di visualizzazione estesa del monitor o EDID) e da qualsiasi override del driver.

Metodi

FromIdAsync(String)

Crea in modo asincrono un oggetto DisplayMonitor per l'identificatore del dispositivo specificato (stringa contenente un percorso dell'istanza del dispositivo PnP). Vedere l'esempio di codice seguente.

Nota

L'argomento deve essere un identificatore del dispositivo e non un identificatore dell'interfaccia del dispositivo. Se si dispone di un identificatore di interfaccia del dispositivo (probabile), chiamare invece FromInterfaceIdAsync . Per altre informazioni, vedere DeviceInformation.Id.

FromInterfaceIdAsync(String)

Crea in modo asincrono un oggetto DisplayMonitor per l'identificatore dell'interfaccia di monitoraggio specificato (stringa contenente un percorso dell'interfaccia del dispositivo PnP). Vedere l'esempio di codice seguente.

Nota

Se si chiama DeviceInformation.FindAllAsync, passando la stringa del selettore dell'interfaccia del dispositivo Advanced Query Syntax (AQS) restituita da DisplayMonitor.GetDeviceSelector, si recupera una raccolta di oggetti DeviceInformation che descrivono le interfacce di monitoraggio (anziché monitorare i dispositivi). Accesso alla proprietà DeviceInformation.Id in uno di questi oggetti recupera un identificatore dell'interfaccia di monitoraggio, che è possibile passare a DisplayMonitor.FromInterfaceIdAsync. Vedere l'esempio di codice seguente.

La maggior parte delle API Win32 che forniscono un identificatore di monitoraggio specifica effettivamente l'identificatore dell'interfaccia di monitoraggio (e non l'identificatore del dispositivo).

GetDescriptor(DisplayMonitorDescriptorKind)

Recupera un descrittore hardware del tipo specificato.

GetDeviceSelector()

Restituisce una stringa del selettore dell'interfaccia del dispositivo advanced query (AQS) allo scopo di recuperare le interfacce del dispositivo (anziché i dispositivi).

Il selettore può essere usato da DeviceInformation.CreateWatcher per watch ed enumerare i dispositivi di monitoraggio nel sistema. In alternativa, può essere usato con DeviceInformation.FindAllAsync per recuperare una raccolta di oggetti DeviceInformation che descrivono le interfacce di monitoraggio anziché monitorare i dispositivi. Accesso alla proprietà DeviceInformation.Id in uno di questi oggetti recupera un identificatore dell'interfaccia di monitoraggio, che è possibile passare a DisplayMonitor.FromInterfaceIdAsync (per informazioni dettagliate, vedere l'esempio di codice per DisplayMonitor.FromInterfaceIdAsync). Se si richiede la proprietà aggiuntiva System.Devices.DeviceInstanceId da FindAllAsync, è possibile chiamare DisplayMonitor.FromIdAsync (per informazioni dettagliate, vedere l'esempio di codice per DisplayMonitor.FromIdAsync).

Si applica a