DXGK_INHERITED_TIMING_INFO 结构 (d3dkmddi.h)

在 DxgkDdiRecommendFunctionalVidPn 的 pPrivateDriverData 参数中传递给驱动程序的结构,驱动程序应使用该结构来描述颜色空间和线路格式,这些颜色空间和线路格式在 DDI 生成的 VidPn 中无法轻松描述

语法

typedef struct _DXGK_INHERITED_TIMING_INFO {
  union {
    D3DDDI_COLOR_SPACE_TYPE             OutputColorSpace;
    D3DDDI_OUTPUT_WIRE_COLOR_SPACE_TYPE OutputWireColorSpace;
  };
  D3DKMDT_WIRE_FORMAT_AND_PREFERENCE SelectedWireFormat;
  union {
    struct {
      DXGK_GLITCH_CAUSE    GlitchCause;
      DXGK_GLITCH_EFFECT   GlitchEffect;
      DXGK_GLITCH_DURATION GlitchDuration;
      UINT8                Reserved;
    };
    UINT DiagnosticInfo;
  };
} DXGK_INHERITED_TIMING_INFO, *PDXGK_INHERITED_TIMING_INFO;

成员

OutputColorSpace

一个 D3DDDI_COLOR_SPACE_TYPE 值,该值描述当前正在为传输像素应用的输出颜色空间。 驱动程序负责发送适当的元数据,以确保将显示设备设置为正确解释此颜色空间的像素。

OutputWireColorSpace

SelectedWireFormat

D3DKMDT_WIRE_FORMAT_AND_PREFERENCE值,该值指示实际使用的线路格式。 尽管可能需要通过调用 DxgkDdiRecommendFunctionalVidPn 返回的 VidPn 中固定的目标模式来描述一种线路格式,但这可能需要驱动程序为启动情况准备一种特殊的目标模式。 相反,此字段应用于报告当前线路颜色编码格式和每个颜色通道的位数。 无论在此字段中报告哪种格式,都应该在通过 DxgkDdiRecommendFunctionalVidPn 报告的目标模式下报告为受支持。

GlitchCause

一个 DXGK_GLITCH_CAUSE 值,该值指示显示管道中导致用户可察觉到的故障的基础更改。

GlitchEffect

一个 DXGK_GLITCH_EFFECT 值,该值指示故障对用户的外观。

GlitchDuration

一个DXGK_GLITCH_DURATION值,该值指示故障的大致持续时间。 请注意,这旨在反映基础问题存在的时长,但在某些情况下,可见效果可能更长。 例如,当同步丢失的时间足够长,导致监视器不得不重新检测时,显示设备可能需要许多帧才能恢复。 这是应报告的基础问题的长度,而不是恢复时间,因为恢复时间因设备而异。

Reserved

该值已预留供系统使用。

DiagnosticInfo

驱动程序为启动显示填写的信息集,用于描述 DxgkDdiStartDevice 的任何副作用。

在许多情况下,故障是不可避免的,因此这些字段会尝试了解用户影响的根本原因和扩展。 OEM 和客户经常在启动期间抱怨故障,因此让驱动程序向 OS 报告故障有助于快速调查此类问题。

要求

要求
Header d3dkmddi.h