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

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

Sintaxis

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

Parámetros

[in] pModeToMatch

Puntero a la estructura DXGI_MODE_DESC1 que describe el modo de presentación que debe coincidir. Los miembros de DXGI_MODE_DESC1 pueden no especificarse, lo que indica ninguna preferencia para ese miembro. Un valor de 0 para Width o Height indica que el valor no está especificado. Si Width o Height es 0, ambos deben ser 0. Un numerador y un denominador de 0 en RefreshRate indican que no está especificado. Otros miembros de DXGI_MODE_DESC1 tienen valores de enumeración que indican que el miembro no está especificado. Si pConcernedDevice es NULL, el miembro Format de DXGI_MODE_DESC1 no puede ser DXGI_FORMAT_UNKNOWN.

[out] pClosestMatch

Puntero a la estructura de DXGI_MODE_DESC1 que recibe una descripción del modo de presentación que coincide más estrechamente con el modo de presentación descrito en pModeToMatch.

[in, optional] pConcernedDevice

Puntero a la interfaz del dispositivo Direct3D. Si este parámetro es NULL, FindClosestMatchingMode1 devuelve solo los modos cuyo formato coincide con el de pModeToMatch; De lo contrario, FindClosestMatchingMode1 devuelve solo 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

Devuelve uno de los códigos de error descritos en el tema DXGI_ERROR .

Comentarios

Los dispositivos Direct3D requieren formatos UNORM.

FindClosestMatchingMode1 busca el modo de presentación más cercano disponible para el modo especificado en pModeToMatch.

Si establece el miembro Estéreo en la estructura DXGI_MODE_DESC1 en la que pModeToMatch apunta para especificar un modo estéreo como entrada, FindClosestMatchingMode1 solo tiene en cuenta los modos estéreo. FindClosestMatchingMode1 solo tiene en cuenta los modos mono si no se establece Estéreo .

FindClosestMatchingMode1 resuelve los miembros clasificados de forma similar de los modos de presentación (es decir, todos los especificados o no especificados, etc.) en el orden siguiente:

1. ScanlineOrdering
2. Escalado
3. Formato
4. Resolución
5. RefreshRate

Cuando FindClosestMatchingMode1 determina el valor más cercano de un miembro determinado, usa miembros coincidentes previamente para filtrar las opciones de lista de modo de presentación y omite otros miembros. Por ejemplo, cuando FindClosestMatchingMode1 coincide con Resolution, ya ha filtrado la lista de modo de presentación por un determinado ScanlineOrdering, Scaling y Format, mientras que omite RefreshRate. Esta ordenación no define el orden absoluto para cada escenario de uso de FindClosestMatchingMode1, ya que la aplicación puede elegir algunos valores inicialmente, lo que cambia eficazmente el orden de resolución de miembros.

FindClosestMatchingMode1 coincide con los miembros del modo de presentación de uno en uno, generalmente en un orden especificado.

Si un miembro no está especificado, FindClosestMatchingMode1 se reemplaza hacia los valores del escritorio relacionado con esta salida. Si esta salida no forma parte del escritorio, FindClosestMatchingMode1 usa la salida de escritorio predeterminada para buscar valores. Si una aplicación usa un modo de visualización totalmente no especificado, FindClosestMatchingMode1 normalmente devuelve un modo de presentación que coincide con la configuración de escritorio de esta salida.
Dado que los miembros no especificados son de menor prioridad que los miembros especificados, FindClosestMatchingMode1 resuelve miembros no especificados más adelante que los miembros especificados.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	dxgi1_2.h
Library	DXGI.lib

Consulte también

IDXGIOutput1