Método IDXGIOutput6::GetDesc1 (dxgi1_6.h)

Obtenga una descripción extendida de la salida que incluye características de color y tipo de conexión.

Sintaxis

HRESULT GetDesc1(
  [out] DXGI_OUTPUT_DESC1 *pDesc
);

Parámetros

[out] pDesc

Tipo: DXGI_OUTPUT_DESC1*

Puntero a la descripción de salida (consulte DXGI_OUTPUT_DESC1).

Valor devuelto

Tipo: HRESULT

Devuelve un código que indica éxito o error. S_OK si se ejecuta correctamente, DXGI_ERROR_INVALID_CALL si pDesc se pasa como NULL.

Comentarios

Algunos escenarios no tienen valores bien definidos para todos los campos de esta estructura. Por ejemplo, si este IDXGIOutput representa un conjunto clonado o duplicado, o si el EDID no tiene datos o no válidos. En estos casos, el sistema operativo proporcionará algunos valores predeterminados que corresponden a una pantalla estándar de SDR.

Las características de color y luminancia notificadas de una salida se pueden ajustar dinámicamente mientras el sistema se ejecuta debido a la acción del usuario o a cambiar las condiciones ambientales. Por lo tanto, las aplicaciones deben consultar periódicamente IDXGIFactory::IsCurrent y volver a crear su IDXGIFactory si devuelve FALSE. A continuación, vuelva a consultar GetDesc1 desde la salida equivalente de la nueva fábrica para recuperar la información de color más reciente.

Para obtener más información sobre cómo escribir aplicaciones que reaccionan dinámicamente para supervisar las funcionalidades, consulte Uso de DirectX con pantallas de alto rango dinámico y Color avanzado.

En un escritorio de PPP alto, GetDesc1 devuelve el tamaño de pantalla visualizados a menos que la aplicación tenga marcado un valor elevado de PPP. Para obtener información sobre cómo escribir aplicaciones Win32 compatibles con PPP, consulta High PPP.

Requisitos

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

Consulte también

DXGI Interfaces

IDXGIOutput6