DisplayMonitor Classe

Definição

Namespace:

Windows.Devices.Display

Fornece informações sobre um dispositivo de monitor de exibição conectado ao sistema.

Esses dados incluem informações comumente usadas do EDID (Dados de Identificação de Exibição Estendida) do monitor, que é um bloco de descritor de exibição padrão do setor que quase todos os monitores usam para fornecer descrições de modos com suporte e informações gerais do dispositivo) e DisplayID (que é um padrão mais recente do setor que fornece um 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

Herança

Object Platform::Object IInspectable DisplayMonitor

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v6.0)

Comentários

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
2004	19041	IsDolbyVisionSupportedInHdrMode

Propriedades

BluePrimary	Obtém o ponto primário azul chromaticity (calculado a partir dos Dados de Identificação de Exibição Estendida do monitor, ou EDID, e quaisquer substituições de driver).
ConnectionKind	Obtém um valor que representa o método abstrato no qual a exibição está conectada (não específica a um protocolo físico).
DeviceId	Obtém o identificador do dispositivo.
DisplayAdapterDeviceId	Obtém o identificador do dispositivo do adaptador de vídeo ao qual o monitor está conectado. Observe que o adaptador de vídeo pode não ser o dispositivo mais adequado para renderização.
DisplayAdapterId	Obtém o LUID (identificador exclusivo local) do adaptador de exibição ao qual o monitor está conectado. Observe que o adaptador de exibição ao qual o monitor está conectado pode não ser o mais adequado para renderização. Um LUID é um valor de 64 bits com garantia de ser exclusivo somente no sistema no qual foi gerado. A exclusividade de um LUID é garantida somente até que o sistema seja reiniciado. Esse LUID é compatível com APIs Direct3D, DisplayConfig e HolographicSpace .
DisplayAdapterTargetId	Obtém uma ID opaca usada pelo adaptador de exibição para identificar a qual conector o monitor está anexado. Essa ID de destino pode ser usada com APIs DisplayConfig .
DisplayName	Obtém um nome amigável para o dispositivo adequado para exibição para um usuário.
GreenPrimary	Obtém o ponto primário verde chromaticity (calculado a partir dos Dados de Identificação de Exibição Estendida do monitor, ou EDID, e quaisquer substituições de driver).
IsDolbyVisionSupportedInHdrMode	Obtém um valor que indica se os metadados do monitor especificaram que ele trata o HDR (alto intervalo dinâmico) como um modo especial do Dolby Vision . Essa API destina-se a ser usada pelo decodificador de vídeo DolbyVision em execução na mídia para reproduzir conteúdo especialmente certificado.
MaxAverageFullFrameLuminanceInNits	Obtém a luminância média máxima de quadro completo do monitor em nits.
MaxLuminanceInNits	Obtém a luminância máxima do monitor em nits.
MinLuminanceInNits	Obtém a luminância mínima do monitor em nits.
NativeResolutionInRawPixels	Obtém a resolução nativa do monitor em pixels brutos.
PhysicalConnector	Obtém um valor que representa o padrão de conector físico usado para conectar a exibição.
PhysicalSizeInInches	Obtém o tamanho diagonal físico do monitor em polegadas.
RawDpiX	Obtém o DPI horizontal físico do monitor (com base na resolução nativa e no tamanho físico do monitor).
RawDpiY	Obtém o DPI vertical físico do monitor (com base na resolução nativa e no tamanho físico do monitor).
RedPrimary	Obtém o ponto primário vermelho de cromática (calculado a partir dos Dados de Identificação de Exibição Estendida do monitor, ou EDID, e quaisquer substituições de driver).
UsageKind	Obtém um valor que representa o uso no qual a exibição está sendo colocada.
WhitePoint	Obtém o ponto em branco de cromática (calculado a partir dos Dados de Identificação de Exibição Estendida do monitor, ou EDID, e quaisquer substituições de driver).

Métodos

FromIdAsync(String)	Cria de forma assíncrona um objeto DisplayMonitor para o identificador de dispositivo especificado (uma cadeia de caracteres que contém um caminho de instância de dispositivo PnP). Confira o exemplo de código abaixo. Observação O argumento deve ser um identificador de dispositivo e não um identificador de interface do dispositivo. Se você tiver um identificador de interface do dispositivo (o que é provável), chame FromInterfaceIdAsync . Para obter mais detalhes, consulte DeviceInformation.Id.
FromInterfaceIdAsync(String)	Cria de forma assíncrona um objeto DisplayMonitor para o identificador de interface do monitor especificado (uma cadeia de caracteres que contém um caminho de interface do dispositivo PnP). Confira o exemplo de código abaixo. Observação Se você chamar DeviceInformation.FindAllAsync, passando a cadeia de caracteres do seletor de interface do dispositivo AQS (Advanced Query Syntax) retornada por DisplayMonitor.GetDeviceSelector, você recuperará uma coleção de objetos DeviceInformation que descrevem interfaces de monitor (em vez de monitorar dispositivos). Acessar a propriedade DeviceInformation.Id em um desses objetos recupera um identificador de interface do monitor, que você pode passar para DisplayMonitor.FromInterfaceIdAsync. Confira o exemplo de código abaixo. A maioria das APIs do Win32 que fornecem um identificador de monitor realmente fornece o identificador de interface do monitor (e não o identificador do dispositivo).
GetDescriptor(DisplayMonitorDescriptorKind)	Recupera um descritor de hardware do tipo especificado.
GetDeviceSelector()	Retorna uma cadeia de caracteres seletora de interface do dispositivo AQS (Sintaxe de Consulta Avançada) para fins de recuperação de interfaces de dispositivo (em vez de dispositivos). O seletor pode ser usado por DeviceInformation.CreateWatcher para watch e enumerar dispositivos monitor no sistema. Ou pode ser usado com DeviceInformation.FindAllAsync para recuperar uma coleção de objetos DeviceInformation que descrevem interfaces de monitor (em vez de monitorar dispositivos). Acessar a propriedade DeviceInformation.Id em um desses objetos recupera um identificador de interface do monitor, que você pode passar para DisplayMonitor.FromInterfaceIdAsync (para obter detalhes, consulte o exemplo de código para DisplayMonitor.FromInterfaceIdAsync). Se você solicitar a propriedade adicional System.Devices.DeviceInstanceId de FindAllAsync, poderá chamar DisplayMonitor.FromIdAsync (para obter detalhes, consulte o exemplo de código para DisplayMonitor.FromIdAsync).