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

[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:

• Compatibilidad con formato DXGI para hardware de nivel de característica 12.1 de Direct3D
• Compatibilidad con formato DXGI para hardware de nivel de característica 12.0 de Direct3D
• Compatibilidad con formato DXGI para hardware de nivel de característica 11.1 de Direct3D
• Compatibilidad con formato DXGI para hardware de nivel de característica 11.0 de Direct3D
• Compatibilidad de hardware con formatos Direct3D 10Level9
• Compatibilidad de hardware con formatos direct3D 10.1
• Compatibilidad de hardware con formatos direct3D 10

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