структура DXGK_CONNECTION_CHANGE (d3dkmddi.h)

Статья
02/06/2025

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

Уникальный идентификатор каждого целевого объекта для сообщаемого перехода. Это значение должно быть уникальным для всех целевых объектов на адаптере и должно быть монотонно увеличиваться для каждого изменения, сообщаемого.

TargetId

Целевой идентификатор, для которого сообщается об изменении. Этот целевой идентификатор должен быть передан операционной системе до и должен находиться в состоянии, поддерживающем данное изменение.

ConnectionStatus

Значение DXGK_CONNECTION_STATUS, указывающее состояние подключения. ConnectionStatus обычно указывает тип изменения, указывающий, какую структуру в члене объединения следует использовать.

Reserved

Зарезервировано для использования системы.

MonitorConnect

Описывает монитор, подключенный. Эта структура используется при ConnectionStatusMonitorStatusConnected.

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

Описывает соединитель текущего целевого объекта. Эта структура используется при ConnectionStatusTargetStatusConnected.

TargetConnect.BaseTargetType

Значение D3DKMDT_VIDEO_OUTPUT_TECHNOLOGY, определяющее технологию вывода видео соединителя текущего целевого объекта. Как и в случае с MonitorConnect.LinkTargetType, значения D3DKMDT_VOT_INTERNAL и D3DKMDT_VOT_MIRACAST не допускаются.

TargetConnect.NewTargetId

TargetJoin

Описывает соединитель целевого объекта присоединения. Эта структура используется при ConnectionStatusTargetStatusJoined.

TargetJoin.BaseTargetType

Значение D3DKMDT_VIDEO_OUTPUT_TECHNOLOGY, определяющее технологию вывода видео соединителя нового целевого объекта. Как и в случае с MonitorConnect.LinkTargetType, значения D3DKMDT_VOT_INTERNAL и D3DKMDT_VOT_MIRACAST не допускаются.

Заметка

Один и тот же BaseTargetType должен быть зарегистрирован для всех целевых объектов, присоединенных друг к другу.

TargetJoin.NewTargetId