DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS 枚举 (dispmprt.h)

项目
08/07/2023

DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS 指定每个目标诊断数据收集的子状态。

语法

typedef enum _DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS {
  DXGK_DIAG_GETDISPLAYSTATE_SUCCESS,
  DXGK_DIAG_GETDISPLAYSTATE_CAUSED_GLITCH,
  DXGK_DIAG_GETDISPLAYSTATE_CHANGED_DISPLAY_STATE,
  DXGK_DIAG_GETDISPLAYSTATE_MONITOR_NOT_CONNECTED,
  DXGK_DIAG_GETDISPLAYSTATE_TIMEOUT,
  DXGK_DIAG_GETDISPLAYSTATE_ERROR_HARDWARE,
  DXGK_DIAG_GETDISPLAYSTATE_ERROR_DRIVER,
  DXGK_DIAG_GETDISPLAYSTATE_VIDPNTARGETID_NOT_FOUND
} DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS;

常量


`DXGK_DIAG_GETDISPLAYSTATE_SUCCESS` 收集诊断信息时，给定 vidpntarget 上未发生错误。
`DXGK_DIAG_GETDISPLAYSTATE_CAUSED_GLITCH` 收集诊断信息时，给定 vidpntarget 上发生了用户可见的故障。
`DXGK_DIAG_GETDISPLAYSTATE_CHANGED_DISPLAY_STATE` 在收集给定 vidpntarget 上的诊断信息时， (硬件或软件) 导致显示状态更改。
`DXGK_DIAG_GETDISPLAYSTATE_MONITOR_NOT_CONNECTED` 在给定的 vidpntarget 上未检测到监视器已连接。
`DXGK_DIAG_GETDISPLAYSTATE_TIMEOUT` 驱动程序在收集给定 vidpntarget 上的诊断信息时遇到超时。
`DXGK_DIAG_GETDISPLAYSTATE_ERROR_HARDWARE` 驱动程序在收集给定 vidpntarget 上的诊断信息时遇到硬件错误。
`DXGK_DIAG_GETDISPLAYSTATE_ERROR_DRIVER` 驱动程序在收集给定 vidpntarget 上的诊断信息时遇到软件错误。
`DXGK_DIAG_GETDISPLAYSTATE_VIDPNTARGETID_NOT_FOUND` 驱动程序在 DDI 调用中找不到 OS 提供的 VidPnTargetId。

注解

DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS枚举是DXGK_DISPLAYSTATE_NONINTRUSIVE结构的成员。它用于通过调用 DxgkDdiGetDisplayStateNonIntrusive 收集显示诊断信息。

在极少数情况下，特定于平台的实现要求驱动程序在调用 DxgkDdiGetDisplayStateNonIntrusive 期间执行侵入性操作，驱动程序应执行这些操作，但必须将 DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS 设置为相应地DXGK_DIAG_GETDISPLAYSTATE_CAUSED_GLITCH或DXGK_DIAG_GETDISPLAYSTATE_CHANGED_DISPLAY_STATE。 OS 可以使用此信息来决定是否仅在给定系统上调用 DDI 以处理错误情况。

子状态信息可帮助驱动程序成功执行整个 DxgkDdiGetDisplayStateNonIntrusive 调用，即使某些目标发生故障或错误也是如此。