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 |