Compartilhar via

Método IDXGIOutput::FindClosestMatchingMode (dxgi.h)

  • Artigo

[A partir do Direct3D 11.1, recomendamos não usar mais FindClosestMatchingMode para localizar o modo de exibição que mais corresponde ao modo de exibição solicitado. Em vez disso, use IDXGIOutput1::FindClosestMatchingMode1, que dá suporte ao modo de exibição estéreo.]

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

Sintaxe

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

Parâmetros

[in] pModeToMatch

Tipo: const DXGI_MODE_DESC*

O modo de exibição desejado (consulte DXGI_MODE_DESC). Membros de DXGI_MODE_DESC não podem ser especificados indicando que não há preferência para esse membro. Um valor de 0 para Width ou Height indica que o valor não é especificado. Se Largura ou Altura forem 0, ambos deverão ser 0. Um numerador e um denominador de 0 em RefreshRate indicam que ele não é especificado. Outros membros de DXGI_MODE_DESC têm valores de enumeração indicando que o membro não é especificado. Se pConcernedDevice for NULL, Format não poderá ser DXGI_FORMAT_UNKNOWN.

[out] pClosestMatch

Tipo: DXGI_MODE_DESC*

O modo que mais corresponde a pModeToMatch.

[in, optional] pConcernedDevice

Tipo: IUnknown*

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

Valor retornado

Tipo: HRESULT

Retorna um dos DXGI_ERROR a seguir.

Comentários

FindClosestMatchingMode se comporta de forma semelhante ao IDXGIOutput1::FindClosestMatchingMode1 , exceto que FindClosestMatchingMode considera apenas os modos de exibição mono. IDXGIOutput1::FindClosestMatchingMode1 considera apenas modos estéreo se você definir o membro Stereo na estrutura DXGI_MODE_DESC1 para a qual pModeToMatch aponta e considerará apenas modos mono se Stereo não estiver definido.

IDXGIOutput1::FindClosestMatchingMode1 retorna um conjunto de modo de exibição correspondente com apenas modos estéreo ou apenas modos mono. FindClosestMatchingMode se comporta como se você especificasse o modo de entrada como mono.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho dxgi.h
Biblioteca DXGI.lib

Confira também

IDXGIOutput