Metodo IDXGIOutput::FindClosestMatchingMode (dxgi.h)

  • Articolo

[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