IDXGIOutput6::GetDesc1 方法 (dxgi1_6.h)

获取输出的扩展说明,包括颜色特征和连接类型。

语法

HRESULT GetDesc1(
  [out] DXGI_OUTPUT_DESC1 *pDesc
);

参数

[out] pDesc

类型: DXGI_OUTPUT_DESC1*

指向输出说明的指针, (看到 DXGI_OUTPUT_DESC1) 。

返回值

类型: HRESULT

返回指示成功或失败的代码。 S_OK如果成功,DXGI_ERROR_INVALID_CALL是否将 pDesc 作为 NULL 传入。

备注

某些方案没有为此结构中的所有字段定义完善的值。 例如,如果此 IDXGIOutput 表示克隆/重复集,或者 EDID 具有缺失或无效的数据。 在这些情况下,OS 将提供一些对应于标准 SDR 显示器的默认值。

在系统运行时,由于用户操作或更改环境条件,输出报告的颜色和亮度特征可以动态调整。 因此,应用应定期查询 IDXGIFactory::IsCurrent,如果返回 FALSE,则重新创建 IDXGIFactory。 然后从新工厂的等效输出中重新查询 GetDesc1 以检索最新的颜色信息。

有关如何编写动态响应监视功能的应用的更多详细信息,请参阅 将 DirectX 与高动态范围显示器和高级颜色配合使用

在高 DPI 桌面上, GetDesc1 返回可视化的屏幕大小,除非应用标记为高 DPI 感知。 有关编写 DPI 感知 Win32 应用的信息,请参阅 高 DPI

要求

   
目标平台 Windows
标头 dxgi1_6.h
Library DXGI.lib

请参阅

DXGI 接口

IDXGIOutput6