DXGK_CONNECTION_CHANGE结构（d3dkmddi.h）

项目
11/08/2024

DXGK_CONNECTION_CHANGE 描述目标链接的最新更新状态。

语法

typedef struct _DXGK_CONNECTION_CHANGE {
  ULONGLONG                      ConnectionChangeId;
  D3DDDI_VIDEO_PRESENT_TARGET_ID TargetId : 24;
  DXGK_CONNECTION_STATUS         ConnectionStatus : 4;
  UINT                           Reserved : 4;
  union {
    struct {
      D3DKMDT_VIDEO_OUTPUT_TECHNOLOGY       LinkTargetType;
      DXGK_CONNECTION_MONITOR_CONNECT_FLAGS MonitorConnectFlags;
    } MonitorConnect;
    struct {
      D3DKMDT_VIDEO_OUTPUT_TECHNOLOGY BaseTargetType;
      D3DDDI_VIDEO_PRESENT_TARGET_ID  NewTargetId;
    } TargetConnect;
    struct {
      D3DKMDT_VIDEO_OUTPUT_TECHNOLOGY BaseTargetType;
      D3DDDI_VIDEO_PRESENT_TARGET_ID  NewTargetId;
    } TargetJoin;
  };
} DXGK_CONNECTION_CHANGE, *PDXGK_CONNECTION_CHANGE;

成员

ConnectionChangeId

报告转换的每个目标唯一 ID。此值在适配器上的所有目标中必须是唯一的，并且对于报告的每个更改，该值必须单调增加。

TargetId

报告更改的目标 ID。此目标 ID 必须之前已报告给 OS，并且必须处于支持给定更改的状态。

ConnectionStatus

一个指定连接状态的 DXGK_CONNECTION_STATUS 值。 ConnectionStatus 通常指示更改类型，指导联合成员内要使用的结构。

Reserved

保留供系统使用。

MonitorConnect

描述已连接的监视器。 MonitorStatusConnected时，ConnectionStatus 使用此结构。

MonitorConnect.LinkTargetType

一个 D3DKMDT_VIDEO_OUTPUT_TECHNOLOGY 值，该值标识已连接的监视器的视频输出技术。不允许 D3DKMDT_VOT_INTERNAL 和 D3DKMDT_VOT_MIRACAST 值。

MonitorConnect.MonitorConnectFlags

具有已连接监视器标志的 DXGK_CONNECTION_MONITOR_CONNECT_FLAGS 结构。此成员从 Windows 11（WDDM 3.0）开始可用。

TargetConnect

描述当前目标的连接器。 TargetStatusConnected时，ConnectionStatus 时使用此结构。

TargetConnect.BaseTargetType

一个 D3DKMDT_VIDEO_OUTPUT_TECHNOLOGY 值，该值标识当前目标的连接器的视频输出技术。与 MonitorConnect.LinkTargetType一样，不允许使用 D3DKMDT_VOT_INTERNAL 和 D3DKMDT_VOT_MIRACAST 值。

TargetConnect.NewTargetId

报告更改的目标 ID。此目标 ID 必须之前已报告给 OS，并且必须处于支持给定更改的状态。

TargetJoin

描述联接目标的连接器。当 ConnectionStatusTargetStatusJoined时，使用此结构。

TargetJoin.BaseTargetType

一个 D3DKMDT_VIDEO_OUTPUT_TECHNOLOGY 值，该值标识新目标的连接器的视频输出技术。与 MonitorConnect.LinkTargetType一样，不允许使用 D3DKMDT_VOT_INTERNAL 和 D3DKMDT_VOT_MIRACAST 值。

注意

对于要相互联接的所有目标，必须报告同一 BaseTargetType。

TargetJoin.NewTargetId

报告更改的目标 ID。此目标 ID 必须之前已报告给 OS，并且必须处于支持给定更改的状态。