Metodo IDXGIOutput::FindClosestMatchingMode (dxgi.h)

Articolo
08/23/2023

[A partire da Direct3D 11.1, è consigliabile non usare più FindClosestMatchingMode per trovare la modalità di visualizzazione più corrispondente alla modalità di visualizzazione richiesta. Usare invece IDXGIOutput1::FindClosestMatchingMode1, che supporta la modalità di visualizzazione stereo.]

Trova la modalità di visualizzazione più simile alla modalità di visualizzazione richiesta.

Sintassi

HRESULT FindClosestMatchingMode(
  [in]           const DXGI_MODE_DESC *pModeToMatch,
  [out]          DXGI_MODE_DESC       *pClosestMatch,
  [in, optional] IUnknown             *pConcernedDevice
);

Parametri

[in] pModeToMatch

Tipo: const DXGI_MODE_DESC*

Modalità di visualizzazione desiderata (vedere DXGI_MODE_DESC). I membri di DXGI_MODE_DESC non possono essere specificati che indicano nessuna preferenza per tale membro. Il valore 0 per Width o Height indica che il valore non è specificato. Se Width o Height sono 0, entrambi devono essere 0. Un numeratore e il denominatore 0 in RefreshRate indicano che non è specificato. Altri membri di DXGI_MODE_DESC hanno valori di enumerazione che indicano che il membro non è specificato. Se pConcernedDevice è NULL, il formato non può essere DXGI_FORMAT_UNKNOWN.

[out] pClosestMatch

Tipo: DXGI_MODE_DESC*

Modalità che corrisponde più strettamente a pModeToMatch.

[in, optional] pConcernedDevice

Tipo: IUnknown*

Puntatore all'interfaccia del dispositivo Direct3D. Se questo parametro è NULL, verranno restituite solo le modalità il cui formato corrisponde a quello di pModeToMatch ; in caso contrario, vengono restituiti solo i formati supportati per l'analisi dal dispositivo. Per informazioni sui formati supportati per l'analisi dal dispositivo a ogni livello di funzionalità:

Valore restituito

Tipo: HRESULT

Restituisce uno dei DXGI_ERROR seguenti.

Commenti

FindClosestMatchingMode si comporta in modo analogo a IDXGIOutput1::FindClosestMatchingMode1 , ad eccezione di FindClosestMatchingMode considera solo le modalità di visualizzazione mono. IDXGIOutput1::FindClosestMatchingMode1 considera solo le modalità stereo se si imposta il membro Stereo nella struttura DXGI_MODE_DESC1 a cui pModeToMatch punta e considera solo le modalità mono se Stereo non è impostato.

IDXGIOutput1::FindClosestMatchingMode1 restituisce un set di modalità schermo corrispondente con solo modalità stereo o solo modalità mono. FindClosestMatchingMode si comporta come se fosse stata specificata la modalità di input come mono.

Requisiti


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

Vedi anche

IDXGIOutput

Condividi tramite