Compartir a través de


DisplayMonitor Clase

Definición

Proporciona información sobre un dispositivo de monitor de pantalla conectado al sistema.

Estos datos incluyen información usada habitualmente de los datos de identificación de visualización extendida del monitor (EDID, que es un bloque de descriptores de pantalla estándar del sector que casi todos los monitores usan para proporcionar descripciones de los modos admitidos y la información general del dispositivo) y DisplayID (que es un estándar del sector más reciente que proporciona un superconjunto de 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
Herencia
Object Platform::Object IInspectable DisplayMonitor
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10, version 1803 (se introdujo en la versión 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v6.0)

Comentarios

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
2004 19041 IsDolbyVisionSupportedInHdrMode

Propiedades

BluePrimary

Obtiene el punto primario azul de cromática (calculado a partir de los datos de identificación de visualización extendida del monitor, o EDID, y cualquier invalidación del controlador).

ConnectionKind

Obtiene un valor que representa el método abstracto en el que la pantalla está conectada (no específica de un protocolo físico).

DeviceId

Obtiene el identificador del dispositivo.

DisplayAdapterDeviceId

Obtiene el identificador de dispositivo del adaptador de pantalla al que está conectado el monitor. Tenga en cuenta que es posible que el adaptador de pantalla no sea el dispositivo más adecuado para la representación.

DisplayAdapterId

Obtiene el identificador único local (LUID) del adaptador de pantalla al que está conectado el monitor. Tenga en cuenta que el adaptador de pantalla al que está conectado el monitor puede no ser el más adecuado para la representación.

Un LUID es un valor de 64 bits que se garantiza que es único solo en el sistema en el que se generó. La unicidad de un LUID solo se garantiza hasta que se reinicie el sistema. Este LUID es compatible con las API de Direct3D, DisplayConfig y HolographicSpace .

DisplayAdapterTargetId

Obtiene un identificador opaco utilizado por el adaptador de pantalla para identificar a qué conector está conectado el monitor. Este identificador de destino se puede usar con las API displayConfig .

DisplayName

Obtiene un nombre descriptivo para el dispositivo adecuado para mostrarlo a un usuario.

GreenPrimary

Obtiene el punto primario verde de cromática (calculado a partir de los datos de identificación de visualización extendida del monitor, o EDID, y cualquier invalidación del controlador).

IsDolbyVisionSupportedInHdrMode

Obtiene un valor que indica si los metadatos del monitor han especificado que trata un alto rango dinámico (HDR) como un modo especial de Dolby Vision . Esta API está pensada para ser utilizada por el descodificador de vídeo DolbyVision que se ejecuta dentro de medios para reproducir contenido especialmente certificado.

MaxAverageFullFrameLuminanceInNits

Obtiene la luminancia media media de marco completo del monitor en nices.

MaxLuminanceInNits

Obtiene la luminancia máxima del monitor en nices.

MinLuminanceInNits

Obtiene la luminancia mínima del monitor en nices.

NativeResolutionInRawPixels

Obtiene la resolución nativa del monitor en píxeles sin procesar.

PhysicalConnector

Obtiene un valor que representa el estándar de conector físico usado para conectar la pantalla.

PhysicalSizeInInches

Obtiene el tamaño de la diagonal física del monitor en pulgadas.

RawDpiX

Obtiene el PPP horizontal físico del monitor (basado en la resolución nativa del monitor y el tamaño físico).

RawDpiY

Obtiene el PPP vertical físico del monitor (basado en la resolución nativa del monitor y el tamaño físico del monitor).

RedPrimary

Obtiene el punto primario rojo de cromática (calculado a partir de los datos de identificación de visualización extendida del monitor, o EDID, y cualquier invalidación del controlador).

UsageKind

Obtiene un valor que representa el uso al que se coloca la pantalla.

WhitePoint

Obtiene el punto blanco de cromatidad (calculado a partir de los datos de identificación de visualización extendida del monitor, o EDID, y cualquier invalidación de controlador).

Métodos

FromIdAsync(String)

Crea de forma asincrónica un objeto DisplayMonitor para el identificador de dispositivo especificado (una cadena que contiene una ruta de acceso de instancia del dispositivo PnP). Consulte el ejemplo de código siguiente.

Nota:

El argumento debe ser un identificador de dispositivo y no un identificador de interfaz de dispositivo. Si tiene un identificador de interfaz de dispositivo (lo que es probable), llame a FromInterfaceIdAsync en su lugar. Para más información, consulte DeviceInformation.Id.

FromInterfaceIdAsync(String)

Crea de forma asincrónica un objeto DisplayMonitor para el identificador de interfaz de monitor especificado (una cadena que contiene una ruta de acceso de interfaz de dispositivo PnP). Consulte el ejemplo de código siguiente.

Nota:

Si llama a DeviceInformation.FindAllAsync, pasando la cadena de selector de interfaz de dispositivo advanced Query Syntax (AQS) devuelta por DisplayMonitor.GetDeviceSelector, recuperará una colección de objetos DeviceInformation que describen interfaces de supervisión (en lugar de supervisar dispositivos). El acceso a la propiedad DeviceInformation.Id en uno de esos objetos recupera un identificador de interfaz de supervisión, que puede pasar a DisplayMonitor.FromInterfaceIdAsync. Consulte el ejemplo de código siguiente.

La mayoría de las API de Win32 que proporcionan un identificador de monitor proporcionan realmente el identificador de interfaz de supervisión (y no el identificador del dispositivo).

GetDescriptor(DisplayMonitorDescriptorKind)

Recupera un descriptor de hardware del tipo especificado.

GetDeviceSelector()

Devuelve una cadena de selector de interfaz de dispositivo de sintaxis de consulta avanzada (AQS) con el fin de recuperar interfaces de dispositivo (en lugar de dispositivos).

DeviceInformation.CreateWatcher puede usar el selector para watch y enumerar dispositivos de supervisión en el sistema. O bien, se puede usar con DeviceInformation.FindAllAsync para recuperar una colección de objetos DeviceInformation que describen interfaces de supervisión (en lugar de supervisar dispositivos). El acceso a la propiedad DeviceInformation.Id en uno de esos objetos recupera un identificador de interfaz de supervisión, que puede pasar a DisplayMonitor.FromInterfaceIdAsync (para obtener más información, vea el ejemplo de código para DisplayMonitor.FromInterfaceIdAsync). Si solicita la propiedad adicional System.Devices.DeviceInstanceId desde FindAllAsync, puede llamar a DisplayMonitor.FromIdAsync (para obtener más información, consulte el ejemplo de código para DisplayMonitor.FromIdAsync).

Se aplica a