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;

Members

[out] Flags

Puntatore a una struttura DXGK_INTEGRATEDDISPLAYFLAGS che descrive le proprietà semplici di una visualizzazione integrata. I valori di orientamento di 0 gradi non indicano alcuna sostituzione 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 azzerato per indicare che non è necessario eseguire l'override. Questo valore esegue l'override dell'intervallo nativo nel descrittore. Poiché il driver è responsabile di fornire il descrittore, l'unico utilizzo previsto di questo override consiste nel descrivere un intervallo che non può essere descritto 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 ampio set 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 di DXGK_MONITORLINKINFO_CAPABILITIES che descrive le funzionalità di collegamento per guidare il monitor. Si tratta delle stesse funzionalità di collegamento di cui il sistema operativo esegue una query da una visualizzazione esterna dopo il plug-hot. 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

Override correlati ai colorimetria per la visualizzazione. Vedere la descrizione di DXGK_COLORIMETRY per le definizioni dei campi e le restrizioni relative alle 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 su 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 abbia 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 deve 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. Usato 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.

Commenti

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 hanno comunemente 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 gli schermi integrati, come indicato in precedenza. Il descrittore deve essere un EDID valido.

Requisiti