estrutura DXGK_QUERYINTEGRATEDDISPLAYOUT2 (d3dkmddi.h)

Usado durante uma consulta para a saída de exibição integrada.

Sintaxe

typedef struct _DXGK_QUERYINTEGRATEDDISPLAYOUT2 {
  [out] DXGK_INTEGRATEDDISPLAYFLAGS        Flags;
  [out] D3DKMDT_VIDEO_SIGNAL_INFO          NativeTiming;
  [out] DXGK_MONITORLINKINFO_CAPABILITIES  LinkCapabilities;
  [out] DXGK_COLORIMETRY                   Colorimetry;
  [out] DXGK_DISPLAY_TECHNOLOGY            DisplayTechnology;
  [out] DXGK_DISPLAY_USAGE                 IntendedUsage;
  [out] BYTE                               Instance;
  [out] DXGK_DISPLAY_DESCRIPTOR_TYPE       DescriptorType;
  [out] D3DKMDT_WIRE_FORMAT_AND_PREFERENCE DitheringSupport;
} DXGK_QUERYINTEGRATEDDISPLAYOUT2, *PDXGK_QUERYINTEGRATEDDISPLAYOUT2;

Membros

[out] Flags

Ponteiro para uma estrutura DXGK_INTEGRATEDDISPLAYFLAGS que descreve propriedades simples de uma exibição integrada. Os valores de orientação de 0 graus não indicam nenhuma substituição do descritor.

[out] NativeTiming

Ponteiro para uma estrutura [D3DKMDT_VIDEO_SIGNAL_INFO]/d3dkmdt/ns-d3dkmdt-_d3dkmdt_video_signal_info.md) que contém informações sobre um tempo nativo da exibição integrada. Deve ser zero para indicar nenhuma substituição. Esse valor substitui o tempo nativo no descritor. Como o driver é responsável por fornecer o descritor, o único uso esperado dessa substituição é descrever um tempo que não pode ser descrito por um EDID, obviamente, uma exibição que tem mais de 4095 pixels endereçáveis em qualquer direção. Se uma substituição NativeTiming for fornecida, o sistema operacional não chamará DxgkDdiRecommendMonitorModes para esse destino. Em geral, os painéis integrados não dão suporte a um grande conjunto de intervalos e o driver deve ser bem correspondido ao EDID fornecido. Se o driver precisar descrever várias substituições para modos de monitor, ele deverá deixar a estrutura NativeTiming zerada e relatar todas as substituições usando DxgkDdiRecommendMonitorModes.

[out] LinkCapabilities

Ponteiro para uma estrutura de DXGK_MONITORLINKINFO_CAPABILITIES que descreve os recursos de link para conduzir o monitor. Esses são os mesmos recursos de link que o sistema operacional consultaria de uma exibição externa após o hot-plug. Como uma exibição integrada é exposta durante a inicialização do driver do adaptador, os recursos são descritos diretamente, em vez de fazer uma chamada DDI adicional.

A partir do WDDM 2.6, esse membro é usado para relatar o suporte à sincronização.

[out] Colorimetry

Substituições relacionadas à colorimetria para a exibição. Consulte a descrição de DXGK_COLORIMETRY para obter as definições de campo e restrições nas combinações de campos.

[out] DisplayTechnology

Valor que representa a tecnologia da exibição. Usado para otimizar a experiência, por exemplo, habilitar um tema mais escuro com conteúdo azul reduzido em telas DXGK_DT_OLED.

[out] IntendedUsage

Valor que indica o uso pretendido pelo fabricante da exibição. O valor relatado deve ser DXGK_DU_GENERIC, a menos que o driver tenha informações indicando um uso mais específico. A expectativa é que, se a exibição integrada for destinada a ser usada para AR, VR ou saída auxiliar, o driver teria que ter tratamento específico suficiente para poder relatar o uso correto.

[out] Instance

Um inteiro baseado em zero para a instância do painel integrado. Usado para ordenar vários painéis integrados. Os valores devem ser exclusivos e contíguos entre destinos integrados, mas não precisam ser relatados em ordem.

[out] DescriptorType

Valor para indicar o tipo de descritor. Para o WDDM 2.4, esse valor deve ser DXGK_DDT_EDID. Do WDDM 2.5 e posterior, DXGK_DDT_EDID ou DXGK_DDT_DISPLAYID é permitido.

[out] DitheringSupport

Um campo D3DKMDT_WIRE_FORMAT_AND_PREFERENCE que contém os sinalizadores para cada formato de fio. O driver deve definir o bit de formato de fio para cada formato em que o driver e o hardware dão suporte à dithering benéfica à qualidade da imagem quando o formato de pixel de origem contiver precisão maior do que o formato de fio.

Comentários

Os campos fornecem atributos de substituição da exibição que podem ser fornecidos por um descritor, mas não podem ser descritos por um EDID ou geralmente estão ausentes ou incorretos em EDIDs. Quando houver um conflito entre o descritor e esses campos de substituição, o sistema operacional usará as substituições quando for válido.

O sistema operacional marcar os campos e falhará na inicialização do driver se algum campo for considerado inconsistente ou inválido. Para a maioria dos campos, a verificação de sanidade significa simplesmente verificar se os valores relatados estão no intervalo, mas os campos Colorimetry, Instance e Descriptor têm validação adicional aplicada. Para Colorimetry, consulte a descrição de DXGK_COLORIMETRY para validação. Os valores de instância são verificados para serem consistentes em todas as exibições integradas, conforme observado acima. O Descritor deve ser um EDID válido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1803
Cabeçalho	d3dkmddi.h