struttura DXGK_QUERYINTEGRATEDDISPLAYOUT2 (d3dkmddi.h)

Utilizzato durante una query per l'output di visualizzazione integrato.

Sintassi

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;

Membri

[out] Flags

Puntatore a una struttura DXGK_INTEGRATEDDISPLAYFLAGS che descrive le proprietà semplici di un display integrato. I valori di orientamento di 0 gradi indicano che non viene eseguito alcun override dal descrittore.

[out] NativeTiming

Puntatore a una struttura [D3DKMDT_VIDEO_SIGNAL_INFO]/d3dkmdt/ns-d3dkmdt-_d3dkmdt_video_signal_info.md) che contiene informazioni su una tempistica nativa dello schermo integrato. Deve essere zero per indicare che non è stato eseguito alcun override. Questo valore esegue l'override della tempistica nativa nel descrittore. Poiché il driver è responsabile di fornire il descrittore, l'unico utilizzo previsto di questo override consiste nel descrivere una tempistica che non può essere descritta da un EDID, soprattutto, un display con più di 4095 pixel indirizzabili in entrambe le direzioni. Se viene fornito un override nativeTiming, il sistema operativo non chiamerà DxgkDdiRecommendMonitorModes per questa destinazione. In genere, i pannelli integrati non supportano un set elevato di intervalli e il driver deve essere ben abbinato all'EDID fornito. Se il driver deve descrivere più sostituzioni per le modalità di monitoraggio, deve lasciare zero la struttura NativeTiming e segnalare tutte le sostituzioni usando DxgkDdiRecommendMonitorModes.

[out] LinkCapabilities

Puntatore a una struttura DXGK_MONITORLINKINFO_CAPABILITIES che descrive le funzionalità di collegamento per guidare il monitor. Si tratta delle stesse funzionalità di collegamento che il sistema operativo eseguirà una query da uno schermo esterno dopo il collegamento a caldo. Poiché un display integrato viene esposto durante l'inizializzazione del driver dell'adattatore, le funzionalità vengono descritte direttamente anziché effettuare una chiamata DDI aggiuntiva.

A partire da WDDM 2.6, questo membro viene usato per segnalare il supporto della sincronizzazione.

[out] Colorimetry

Sostituzioni correlate ai colorimetria per la visualizzazione. Vedere la descrizione di DXGK_COLORIMETRY per le definizioni di campo e le restrizioni sulle combinazioni di campi.

[out] DisplayTechnology

Valore che rappresenta la tecnologia dello schermo. Usato per ottimizzare l'esperienza, ad esempio abilitando un tema più scuro con contenuto blu ridotto nei DXGK_DT_OLED display.

[out] IntendedUsage

Valore che indica l'utilizzo previsto del produttore dello schermo. Il valore segnalato deve essere DXGK_DU_GENERIC, a meno che il driver non disponga di informazioni che indicano un utilizzo più specifico. L'aspettativa è che se lo schermo integrato deve essere usato per l'output AR, VR o ausiliario, il driver dovrà avere una gestione abbastanza specifica che sarebbe in grado di segnalare l'utilizzo corretto.

[out] Instance

Intero in base zero per l'istanza del pannello integrato. Utilizzato per ordinare più pannelli integrati. I valori devono essere univoci e contigui tra destinazioni integrate, ma non devono essere segnalati in ordine.

[out] DescriptorType

Valore per indicare il tipo di descrittore. Per WDDM 2.4 questo valore deve essere DXGK_DDT_EDID. Da WDDM 2.5 e versioni successive è consentito DXGK_DDT_EDID o DXGK_DDT_DISPLAYID.

[out] DitheringSupport

Campo D3DKMDT_WIRE_FORMAT_AND_PREFERENCE che contiene i flag per ogni formato di collegamento. Il driver deve impostare il bit in formato wire per ogni formato in cui il driver e l'hardware supportano il dithering vantaggioso per la qualità dell'immagine quando il formato pixel di origine contiene una precisione maggiore rispetto al formato wire.The driver and hardware supports dithering beneficial to image quality when the source pixel format contains higher precision than the wire-format.

Osservazioni

I campi forniscono gli attributi di override della visualizzazione che possono essere forniti da un descrittore, ma non possono essere descritti da un EDID o in genere mancanti o non corretti negli EDID. In caso di conflitto tra il descrittore e questi campi di override, il sistema operativo userà gli override quando validi.

Il sistema operativo verificherà la integrità dei campi e non riuscirà l'avvio del driver se vengono rilevati campi incoerenti o non validi. Per la maggior parte dei campi, il controllo della integrità significa semplicemente verificare che i valori segnalati siano compresi nell'intervallo, ma i campi Colorimetry, Instance e Descriptor hanno ulteriormente applicato la convalida. Per Colorimetry, vedere la descrizione di DXGK_COLORIMETRY per la convalida. I valori dell'istanza vengono verificati in modo che siano coerenti in tutti i display integrati, come indicato in precedenza. Il descrittore deve essere un EDID valido.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1803
intestazione	d3dkmddi.h