Método IDXGIOutput1::FindClosestMatchingMode1 (dxgi1_2.h)

Localiza o modo de exibição que corresponde mais de perto ao modo de exibição solicitado.

Sintaxe

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

Parâmetros

[in] pModeToMatch

Um ponteiro para a estrutura DXGI_MODE_DESC1 que descreve o modo de exibição a ser correspondido. Os membros de DXGI_MODE_DESC1 podem ser não especificados, o que indica nenhuma preferência para esse membro. Um valor de 0 para Width ou Height indica que o valor não é especificado. Se Width ou Height for 0, ambos deverão ser 0. Um numerador e um denominador de 0 em RefreshRate indicam que ele não é especificado. Outros membros do DXGI_MODE_DESC1 têm valores de enumeração que indicam que o membro não é especificado. Se pConcernedDevice for NULL, o membro Format de DXGI_MODE_DESC1 não poderá ser DXGI_FORMAT_UNKNOWN.

[out] pClosestMatch

Um ponteiro para a estrutura DXGI_MODE_DESC1 que recebe uma descrição do modo de exibição que mais corresponde ao modo de exibição descrito em pModeToMatch.

[in, optional] pConcernedDevice

Um ponteiro para a interface do dispositivo Direct3D. Se esse parâmetro for NULL, FindClosestMatchingMode1 retornará apenas modos cujo formato corresponde ao de pModeToMatch; caso contrário, FindClosestMatchingMode1 retorna apenas os formatos com suporte para verificação pelo dispositivo. Para obter informações sobre os formatos com suporte para verificação pelo dispositivo em cada nível de recurso:

• Suporte ao formato DXGI para hardware de nível de recurso Direct3D 12.1
• Suporte ao formato DXGI para hardware de nível de recurso Direct3D 12.0
• Suporte ao formato DXGI para hardware de nível de recurso Direct3D 11.1
• Suporte ao formato DXGI para hardware de nível de recurso Direct3D 11.0
• Suporte de hardware para formatos Direct3D 10Level9
• Suporte de hardware para formatos Direct3D 10.1
• Suporte de hardware para formatos Direct3D 10

Retornar valor

Retorna um dos códigos de erro descritos no tópico DXGI_ERROR .

Comentários

Os dispositivos Direct3D exigem formatos UNORM.

FindClosestMatchingMode1 localiza o modo de exibição disponível correspondente mais próximo ao modo especificado em pModeToMatch.

Se você definir o membro Stereo na estrutura DXGI_MODE_DESC1 à qual pModeToMatch aponta para especificar um modo estéreo como entrada, FindClosestMatchingMode1 considera apenas modos estéreo. FindClosestMatchingMode1 considera apenas modos mono se Stereo não estiver definido.

FindClosestMatchingMode1 resolve membros de modos de exibição classificados da mesma forma (ou seja, todos especificados ou todos não especificados e assim por diante) na seguinte ordem:

1. ScanlineOrdering
2. Dimensionamento
3. Formato
4. Resolução
5. RefreshRate

Quando FindClosestMatchingMode1 determina o valor mais próximo de um membro específico, ele usa membros correspondentes anteriormente para filtrar as opções de lista do modo de exibição e ignora outros membros. Por exemplo, quando FindClosestMatchingMode1 corresponde à Resolução, ele já filtrava a lista de modos de exibição por um determinado ScanlineOrdering, Scaling e Format, enquanto ignora RefreshRate. Essa ordenação não define a ordenação absoluta para cada cenário de uso de FindClosestMatchingMode1, pois o aplicativo pode escolher alguns valores inicialmente, o que efetivamente altera a ordem de resolução de membros.

FindClosestMatchingMode1 corresponde aos membros do modo de exibição um de cada vez, geralmente em uma ordem especificada.

Se um membro não for especificado, FindClosestMatchingMode1 gravita em direção aos valores da área de trabalho relacionada a essa saída. Se essa saída não fizer parte da área de trabalho, FindClosestMatchingMode1 usará a saída da área de trabalho padrão para localizar valores. Se um aplicativo usa um modo de exibição totalmente não especificado, FindClosestMatchingMode1 normalmente retorna um modo de exibição que corresponde às configurações da área de trabalho para essa saída.
Como os membros não especificados são de prioridade mais baixa do que os membros especificados, FindClosestMatchingMode1 resolve membros não especificados posteriores aos membros especificados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	dxgi1_2.h
Biblioteca	DXGI.lib

Confira também

IDXGIOutput1