Metodo IDXGIOutput1::FindClosestMatchingMode1 (dxgi1_2.h)

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

Sintassi

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

Parametri

[in] pModeToMatch

Puntatore alla struttura DXGI_MODE_DESC1 che descrive la modalità di visualizzazione da trovare. I membri di DXGI_MODE_DESC1 possono essere non specificati, che indica nessuna preferenza per tale membro. Il valore 0 per Width o Height indica che il valore non è specificato. Se Width o Height è 0, entrambi devono essere 0. Un numeratore e il denominatore 0 in RefreshRate indicano che non è specificato. Altri membri di DXGI_MODE_DESC1 hanno valori di enumerazione che indicano che il membro non è specificato. Se pConcernedDevice è NULL, il membro Format di DXGI_MODE_DESC1 non può essere DXGI_FORMAT_UNKNOWN.

[out] pClosestMatch

Puntatore alla struttura DXGI_MODE_DESC1 che riceve una descrizione della modalità di visualizzazione più simile alla modalità di visualizzazione descritta in pModeToMatch.

[in, optional] pConcernedDevice

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

• Supporto del formato DXGI per hardware Direct3D Livello di funzionalità 12.1
• Supporto del formato DXGI per l'hardware di livello di funzionalità Direct3D 12.0
• Supporto del formato DXGI per hardware Di livello 11.1 Direct3D
• Supporto del formato DXGI per l'hardware di livello di funzionalità Direct3D 11.0
• Supporto hardware per formati Direct3D 10Level9
• Supporto hardware per formati Direct3D 10.1
• Supporto hardware per formati Direct3D 10

Valore restituito

Restituisce uno dei codici di errore descritti nell'argomento DXGI_ERROR .

Commenti

I dispositivi Direct3D richiedono formati UNORM.

FindClosestMatchingMode1 trova la modalità di visualizzazione disponibile più vicina alla modalità specificata in pModeToMatch.

Se imposti il membro Stereo nella struttura DXGI_MODE_DESC1 su cui pModeToMatch punta per specificare una modalità stereo come input, FindClosestMatchingMode1 considera solo le modalità stereo. FindClosestMatchingMode1 considera solo le modalità mono se Stereo non è impostato.

FindClosestMatchingMode1 risolve i membri classificati in modo analogo delle modalità di visualizzazione, ovvero tutte le modalità specificate o tutte non specificate e così via, nell'ordine seguente:

1. ScanlineOrdering
2. Ridimensionamento
3. Formato
4. Risoluzione
5. RefreshRate

Quando FindClosestMatchingMode1 determina il valore più vicino per un determinato membro, usa membri corrispondenti in precedenza per filtrare le scelte dell'elenco della modalità di visualizzazione e ignora altri membri. Ad esempio, quando FindClosestMatchingMode1 corrisponde a Resolution, ha già filtrato l'elenco della modalità di visualizzazione in base a un determinato ScanlineOrdering, Scaling e Format, mentre ignora RefreshRate. Questo ordinamento non definisce l'ordinamento assoluto per ogni scenario di utilizzo di FindClosestMatchingMode1, perché l'applicazione può scegliere inizialmente alcuni valori, che modificano in modo efficace l'ordine di risoluzione dei membri.

FindClosestMatchingMode1 corrisponde ai membri della modalità di visualizzazione uno alla volta, in genere in un ordine specificato.

Se un membro non è specificato, FindClosestMatchingMode1 gravita verso i valori per il desktop correlato a questo output. Se questo output non fa parte del desktop, FindClosestMatchingMode1 usa l'output desktop predefinito per trovare i valori. Se un'applicazione usa una modalità di visualizzazione completamente non specificata, FindClosestMatchingMode1 restituisce in genere una modalità di visualizzazione che corrisponde alle impostazioni desktop per questo output.
Poiché i membri non specificati sono con priorità inferiore rispetto ai membri specificati, FindClosestMatchingMode1 risolve i membri non specificati in un secondo momento rispetto ai membri specificati.

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