DXGK_DISPLAYMUX_INTERFACE_2结构（dispmprt.h）

项目
01/16/2025

DXGK_DISPLAYMUX_INTERFACE_2 结构包含指向内核模式显示微型端口驱动程序（KMD）实现的函数的指针，以支持自动显示切换功能的版本 2。

语法

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 DxgkDdiDisplayMuxReportPresence 回调函数的指针。

DxgkDdiDisplayMuxSetInternalPanelInfo

[out]指向 KMD DxgkDdiDisplayMuxSetInternalPanelInfo 回调函数的指针。

言论

操作系统在驱动程序启动时查询 KMD 的 DXGK_DISPLAYMUX_INTERFACE_2。它通过调用 KMD 的 DxgkDdiQueryInterface 函数，将 QueryInterface->InterfaceType 设置为GUID_WDDM_INTERFACE_DISPLAYMUX_2来执行此操作。如果 KMD 支持此接口，它将返回一个 DXGK_DISPLAYMUX_INTERFACE_2 结构，其中包含指向其自动显示开关回调的指针。

公开GUID_WDDM_INTERFACE_DISPLAYMUX_2接口的驱动程序必须设置 DXGK_CHILD_CAPABILITIES。如果复用器当前未切换到驱动程序的 GPU，Type.IntegratedDisplayChild.DescriptorLength 在适配器启动时 为零。否则，OS 将失败适配器启动。

有关详细信息，请参阅自动显示开关。