DisplayMonitor Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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). |