Metodo IDXGIOutput::GetDisplayModeList (dxgi.h)

Articolo
08/23/2023

[A partire da Direct3D 11.1, è consigliabile non usare più GetDisplayModeList per recuperare la modalità di visualizzazione corrispondente. Usare invece IDXGIOutput1::GetDisplayModeList1, che supporta la modalità di visualizzazione stereo.

Ottiene le modalità di visualizzazione corrispondenti al formato richiesto e ad altre opzioni di input.

Sintassi

HRESULT GetDisplayModeList(
                  DXGI_FORMAT    EnumFormat,
                  UINT           Flags,
  [in, out]       UINT           *pNumModes,
  [out, optional] DXGI_MODE_DESC *pDesc
);

Parametri

EnumFormat

Tipo: DXGI_FORMAT

Formato del colore (vedere DXGI_FORMAT).

Flags

Tipo: UINT

Opzioni per le modalità da includere (vedere DXGI_ENUM_MODES). DXGI_ENUM_MODES_SCALING deve essere specificato per esporre le modalità di visualizzazione che richiedono il ridimensionamento. Le modalità centrate, che non richiedono scalabilità e corrispondenti direttamente all'output di visualizzazione, vengono enumerate per impostazione predefinita.

[in, out] pNumModes

Tipo: UINT*

Impostare pDesc su NULL in modo che pNumModes restituisca il numero di modalità di visualizzazione corrispondenti al formato e alle opzioni. In caso contrario, pNumModes restituisce il numero di modalità di visualizzazione restituite in pDesc.

[out, optional] pDesc

Tipo: DXGI_MODE_DESC*

Puntatore a un elenco di modalità di visualizzazione (vedere DXGI_MODE_DESC); impostare su NULL per ottenere il numero di modalità di visualizzazione.

Valore restituito

Tipo: HRESULT

Restituisce uno dei DXGI_ERROR seguenti. È raro, ma possibile, che le modalità di visualizzazione disponibili possano cambiare immediatamente dopo aver chiamato questo metodo, nel qual caso DXGI_ERROR_MORE_DATA viene restituito (se non è disponibile spazio sufficiente per tutte le modalità di visualizzazione).
Se GetDisplayModeList viene chiamato da una sessione di Servizi Desktop remoto (in precedenza sessione di Servizi Terminal), viene restituito DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.

Commenti

In generale, quando si passa dalla modalità finestra a schermo intero, una catena di scambio sceglie automaticamente una modalità di visualizzazione che soddisfa (o supera) la risoluzione, la profondità del colore e la frequenza di aggiornamento della catena di scambio. Per esercitare un maggiore controllo sulla modalità di visualizzazione, usare questa API per eseguire il polling del set di modalità di visualizzazione convalidate in base alle funzionalità di monitoraggio o a tutte le modalità che corrispondono al desktop (se le impostazioni del desktop non vengono convalidate rispetto al monitor).

Come illustrato, questa API è progettata per essere chiamata due volte. Prima di ottenere il numero di modalità disponibili e la seconda per restituire una descrizione delle modalità.


UINT num = 0;
DXGI_FORMAT format = DXGI_FORMAT_R32G32B32A32_FLOAT;
UINT flags         = DXGI_ENUM_MODES_INTERLACED;

pOutput->GetDisplayModeList( format, flags, &num, 0);

...

DXGI_MODE_DESC * pDescs = new DXGI_MODE_DESC[num];
pOutput->GetDisplayModeList( format, flags, &num, pDescs);

Requisiti


Piattaforma di destinazione	Windows
Intestazione	dxgi.h
Libreria	DXGI.lib

Vedi anche

IDXGIOutput

Condividi tramite