Metodo IDXGIOutput6::GetDesc1 (dxgi1_6.h)

Ottenere una descrizione estesa dell'output che include le caratteristiche dei colori e il tipo di connessione.

Sintassi

HRESULT GetDesc1(
  [out] DXGI_OUTPUT_DESC1 *pDesc
);

Parametri

[out] pDesc

Tipo: DXGI_OUTPUT_DESC1*

Puntatore alla descrizione dell'output (vedere DXGI_OUTPUT_DESC1).

Valore restituito

Tipo: HRESULT

Restituisce un codice che indica l'esito positivo o negativo. S_OK in caso di esito positivo, DXGI_ERROR_INVALID_CALL se pDesc viene passato come NULL.

Commenti

Alcuni scenari non hanno valori ben definiti per tutti i campi in questo struct. Ad esempio, se questo IDXGIOutput rappresenta un set clone/duplicato o se l'EDID contiene dati mancanti o non validi. In questi casi, il sistema operativo fornirà alcuni valori predefiniti che corrispondono a una visualizzazione SDR standard.

Le caratteristiche di colore e luminanza segnalate di un output possono modificare dinamicamente mentre il sistema è in esecuzione a causa dell'azione dell'utente o della modifica delle condizioni di ambiente. Pertanto, le app devono eseguire periodicamente query su IDXGIFactory::IsCurrent e ricrearne IDXGIFactory se restituisce FALSE. Eseguire quindi una nuova query su GetDesc1 dall'output equivalente della nuova factory per recuperare le informazioni sul colore più recenti.

Per altre informazioni su come scrivere app che reagiscono in modo dinamico per monitorare le funzionalità, vedere Uso di DirectX con schermi a intervalli dinamici elevati e Colore avanzato.

In un desktop con valori DPI elevati GetDesc1 restituisce le dimensioni dello schermo visualizzate, a meno che l'app non sia contrassegnata con valori DPI elevati. Per informazioni sulla scrittura di app Win32 compatibili con DPI, vedi DPI elevato.

Requisiti

Vedi anche

Interfacce DXGI

IDXGIOutput6