структура DXGK_DISPLAYMUX_INTERFACE_2 (dispmprt.h)

Статья
01/16/2025

Структура DXGK_DISPLAYMUX_INTERFACE_2 содержит указатели на функции, реализованные мини-драйвером минипорта (KMD) ядра для поддержки функции автоматического переключения .

Синтаксис

typedef struct _DXGK_DISPLAYMUX_INTERFACE_2 {
  USHORT                                              Size;
  USHORT                                              Version;
  PVOID                                               Context;
  PINTERFACE_REFERENCE                                InterfaceReference;
  PINTERFACE_DEREFERENCE                              InterfaceDereference;
  DXGKDDI_DISPLAYMUX_GET_DRIVER_SUPPORT_LEVEL         DxgkDdiDisplayMuxGetDriverSupportLevel;
  DXGKDDI_DISPLAYMUX_GET_RUNTIME_STATUS               DxgkDdiDisplayMuxGetRuntimeStatus;
  DXGKDDI_DISPLAYMUX_PRE_SWITCH_AWAY                  DxgkDdiDisplayMuxPreSwitchAway;
  DXGKDDI_DISPLAYMUX_PRE_SWITCH_AWAY_GET_PRIVATE_DATA DxgkDdiDisplayMuxPreSwitchAwayGetPrivateData;
  DXGKDDI_DISPLAYMUX_PRE_SWITCH_TO                    DxgkDdiDisplayMuxPreSwitchTo;
  DXGKDDI_DISPLAYMUX_SWITCH_CANCELED                  DxgkDdiDisplayMuxSwitchCanceled;
  DXGKDDI_DISPLAYMUX_POST_SWITCH_AWAY                 DxgkDdiDisplayMuxPostSwitchAway;
  DXGKDDI_DISPLAYMUX_POST_SWITCH_TO_PHASE1            DxgkDdiDisplayMuxPostSwitchToPhase1;
  DXGKDDI_DISPLAYMUX_POST_SWITCH_TO_PHASE2            DxgkDdiDisplayMuxPostSwitchToPhase2;
  DXGKDDI_DISPLAYMUX_UPDATE_STATE                     DxgkDdiDisplayMuxUpdateState;
  DXGKDDI_DISPLAYMUX_REPORT_PRESENCE                  DxgkDdiDisplayMuxReportPresence;
  DXGKDDI_DISPLAYMUX_SET_INTERNAL_PANEL_INFO          DxgkDdiDisplayMuxSetInternalPanelInfo;
} DXGK_DISPLAYMUX_INTERFACE_2, *PDXGK_DISPLAYMUX_INTERFACE_2;

Члены

Size

[in] Размер этой структуры в байтах.

Version

[in] Номер версии интерфейса многомерного отображения. версии необходимо задать DXGK_DISPLAYMUX_INTERFACE_VERSION_1 для этой структуры.

Context

[in] Указатель на блок частного контекста.

InterfaceReference

[out] Указатель на эталонную функцию интерфейса, реализованную KMD.

InterfaceDereference

[out] Указатель на функцию расшифровки интерфейса, реализованную KMD.

DxgkDdiDisplayMuxGetDriverSupportLevel

[out] Указатель на функцию обратного вызова KMD DxgkDdiDisplayMuxGetDriverSupportLevel.

DxgkDdiDisplayMuxGetRuntimeStatus

[out] Указатель на функцию обратного вызова KMD DxgkDdiDisplayMuxGetRuntimeStatus.

DxgkDdiDisplayMuxPreSwitchAway

[out] Указатель на функцию обратного вызова KMD DxgkDdiDisplayMuxPreSwitchAway.

DxgkDdiDisplayMuxPreSwitchAwayGetPrivateData

[out] Указатель на функцию обратного вызова KMD DxgkDdiDisplayMuxPreSwitchAwayGetPrivateData обратного вызова.

DxgkDdiDisplayMuxPreSwitchTo

[out] Указатель на функцию обратного вызова KMD DxgkDdiDisplayMuxPreSwitchTo.

DxgkDdiDisplayMuxSwitchCanceled

[out] Указатель на функцию обратного вызова KMD DxgkDdiDisplayMuxSwitchCanceled.

DxgkDdiDisplayMuxPostSwitchAway

[out] Указатель на функцию обратного вызова KMD dxgkDdiDisplayMuxPostSwitchAway обратного вызова.

DxgkDdiDisplayMuxPostSwitchToPhase1

[out] Указатель на функцию обратного вызова KMD DxgkDdiDisplayMuxPostSwitchToPhase1 обратного вызова.

DxgkDdiDisplayMuxPostSwitchToPhase2

[out] Указатель на функцию обратного вызова KMD DxgkDdiDisplayMuxPostSwitchToPhase2.

DxgkDdiDisplayMuxUpdateState

[out] Указатель на функцию обратного вызова KMD DxgkDdiDisplayMuxUpdateState.

DxgkDdiDisplayMuxReportPresence

[out] Указатель на функцию обратного вызова KMD DxgkDdiDisplayMuxReportPres ence.

DxgkDdiDisplayMuxSetInternalPanelInfo

[out] Указатель на функцию обратного вызова KMD DxgkDdiDisplayMuxSetInternalPanelInfo.

Замечания

Ос запрашивает DXGK_DISPLAYMUX_INTERFACE_2 KMD при запуске драйвера. Это делается путем вызова функции KMD DxgkDdiQueryInterface с QueryInterface->InterfaceType, для которых задано значение GUID_WDDM_INTERFACE_DISPLAYMUX_2. Если KMD поддерживает этот интерфейс, он возвращает DXGK_DISPLAYMUX_INTERFACE_2 структуру с указателями на обратные вызовы автоматического переключателя отображения.

Драйвер, предоставляющий интерфейс GUID_WDDM_INTERFACE_DISPLAYMUX_2, должен задать DXGK_CHILD_CAPABILITIES. Type.IntegratedDisplayChild.DescriptorLength к нулю при запуске адаптера, если мьюкс в настоящее время не переключится на GPU драйвера. В противном случае ОС завершится сбоем запуска адаптера.

Дополнительные сведения см. в автоматического переключателя отображения.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 11 версии 24H2, обновление 2025.01 (WDDM 3.2)
заголовка	dispmprt.h

См. также

DxgkddiAddevice

DxgkDdiQueryInterface

QUERY_INTERFACE

Поделиться через