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

  • Artículo

[A partir de Direct3D 11.1, se recomienda no usar FindClosestMatchingMode para encontrar el modo de presentación que coincida con el modo de presentación solicitado. En su lugar, use IDXGIOutput1::FindClosestMatchingMode1, que admite el modo de presentación estéreo.]

Busca el modo de presentación que coincide más estrechamente con el modo de presentación solicitado.

Sintaxis

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*

Modo de presentación deseado (consulte DXGI_MODE_DESC). Los miembros de DXGI_MODE_DESC pueden no especificarse que no indiquen ninguna preferencia para ese miembro. Un valor de 0 para Width o Height indica que el valor no está especificado. Si Width o Height son 0, ambos deben ser 0. Un numerador y un denominador de 0 en RefreshRate indican que no está especificado. Otros miembros de DXGI_MODE_DESC tienen valores de enumeración que indican que el miembro no está especificado. Si pConcernedDevice es NULL, el formato no puede ser DXGI_FORMAT_UNKNOWN.

[out] pClosestMatch

Tipo: DXGI_MODE_DESC*

Modo que coincide más estrechamente con pModeToMatch.

[in, optional] pConcernedDevice

Tipo: IUnknown*

Puntero a la interfaz del dispositivo Direct3D. Si este parámetro es NULL, solo se devolverán los modos cuyo formato coincida con el de pModeToMatch ; De lo contrario, solo se devuelven los formatos admitidos para el examen por parte del dispositivo. Para obtener información sobre los formatos admitidos para el examen por parte del dispositivo en cada nivel de característica:

Valor devuelto

Tipo: HRESULT

Devuelve uno de los siguientes DXGI_ERROR.

Comentarios

FindClosestMatchingMode se comporta de forma similar a IDXGIOutput1::FindClosestMatchingMode1 , excepto FindClosestMatchingMode , solo tiene en cuenta los modos de presentación mono. IDXGIOutput1::FindClosestMatchingMode1 solo tiene en cuenta los modos estéreo si establece el miembro Estéreo en la estructura de DXGI_MODE_DESC1 a la que apunta pModeToMatch y solo tiene en cuenta los modos mono si estereo no está establecido.

IDXGIOutput1::FindClosestMatchingMode1 devuelve un conjunto de modo de presentación coincidente con solo modos estéreo o solo modos mono. FindClosestMatchingMode se comporta como si especificara el modo de entrada como mono.

Requisitos

   
Plataforma de destino Windows
Encabezado dxgi.h
Library DXGI.lib

Consulte también

IDXGIOutput