DXGK_CONNECTION_CHANGE structure (d3dkmddi.h)

Article
08/26/2022

DXGK_CONNECTION_CHANGE describes the most recently updated status of the link for a target.

Syntax

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;

Members

ConnectionChangeId

The per target unique ID for the transition being reported. This value must be unique across all targets on the adapter and must be monotonically increasing for each change reported.

TargetId

The target ID for which the change is being reported. This target ID must have been reported to the OS before and must be in a state that supports the given change.

ConnectionStatus

A DXGK_CONNECTION_STATUS value that specifies the status of the connection.

Reserved

Reserved for system use.

MonitorConnect

Describes the monitor that has been connected.

MonitorConnect.LinkTargetType

A D3DKMDT_VIDEO_OUTPUT_TECHNOLOGY value that identifies the video output technology of the monitor that has been connected. The D3DKMDT_VOT_INTERNAL and D3DKMDT_VOT_MIRACAST values are not allowed.

MonitorConnect.MonitorConnectFlags

A DXGK_CONNECTION_MONITOR_CONNECT_FLAGS structure with flags for the connected monitor.

TargetConnect

Describes the current target's connector.

TargetConnect.BaseTargetType

A D3DKMDT_VIDEO_OUTPUT_TECHNOLOGY value that identifies the video output technology of the current target's connector. As with MonitorConnect.LinkTargetType, the D3DKMDT_VOT_INTERNAL and D3DKMDT_VOT_MIRACAST values are not allowed.

TargetConnect.NewTargetId

The target ID for which the change is being reported. This target ID must have been reported to the OS before and must be in a state which supports the given change.

TargetConnect.BaseTargetType

TargetConnect.NewTargetId

TargetJoin

Describes the joining target's connector.

TargetJoin.BaseTargetType

This is the video output technology of the connector of the new target. As with MonitorConnect.LinkTargetType, the D3DKMDT_VOT_INTERNAL and D3DKMDT_VOT_MIRACAST values are not allowed.

Note

The same BaseTargetType must be reported for all targets that are being joined to each other.

TargetJoin.NewTargetId

The target ID for which the change is being reported. This target ID must have been reported to the OS before and must be in a state which supports the given change.

TargetJoin.BaseTargetType

TargetJoin.NewTargetId

Requirements

Requirement	Value
Header	d3dkmddi.h