Metodo IDXGIOutput1::GetDisplayModeList1 (dxgi1_2.h)

Articolo
03/05/2024

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

Sintassi

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

Parametri

EnumFormat

Valore tipizzato DXGI_FORMAT per il formato di colore.

Flags

Combinazione di valori tipizzati DXGI_ENUM_MODES combinati tramite un'operazione OR bit per bit. Il valore risultante specifica le opzioni per le modalità di visualizzazione da includere. È necessario specificare DXGI_ENUM_MODES_SCALING per esporre le modalità di visualizzazione che richiedono il ridimensionamento. Le modalità centrate che non richiedono il ridimensionamento e corrispondono direttamente all'output di visualizzazione vengono enumerate per impostazione predefinita.

[in, out] pNumModes

Puntatore a una variabile che riceve il numero di modalità di visualizzazione restituite da GetDisplayModeList1 nel blocco di memoria in cui pDesc punta. 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

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

Valore restituito

Restituisce uno dei codici di errore descritti nell'argomento DXGI_ERROR . È 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).

Commenti

GetDisplayModeList1 viene aggiornato da GetDisplayModeList per restituire un elenco di strutture DXGI_MODE_DESC1 , che sono descrizioni della modalità aggiornate. GetDisplayModeList si comporta come se chiama GetDisplayModeList1 perché GetDisplayModeList può restituire tutte le modalità specificate da DXGI_ENUM_MODES, inclusa la modalità stereo. Tuttavia, GetDisplayModeList restituisce un elenco di strutture DXGI_MODE_DESC , che sono le descrizioni della modalità precedente e non indicano la modalità stereo.

Il metodo GetDisplayModeList1 non enumera le modalità stereo a meno che non si specifichi il flag DXGI_ENUM_MODES_STEREO nel parametro Flags . Se si specifica DXGI_ENUM_MODES_STEREO, le modalità stereo vengono incluse nell'elenco delle modalità restituite a cui punta il parametro pDesc . In altre parole, il metodo restituisce modalità stereo e mono.

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 GetDisplayModeList1 per eseguire il polling del set di modalità di visualizzazione convalidate rispetto alle funzionalità di monitoraggio o a tutte le modalità che corrispondono al desktop (se le impostazioni desktop non vengono convalidate rispetto al monitor).

Il codice di esempio seguente mostra che è necessario chiamare GetDisplayModeList1 due volte. Chiamare innanzitutto GetDisplayModeList1 per ottenere il numero di modalità disponibili e la seconda chiamata a GetDisplayModeList1 per restituire una descrizione delle modalità.


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

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

...

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e aggiornamento della piattaforma per Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 e aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	dxgi1_2.h
Libreria	DXGI.lib

Vedi anche

IDXGIOutput1

Condividi tramite