DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET回调函数（d3dkmddi.h）

项目
02/06/2025

pfnGetAdditionalMonitorModeSet 函数将句柄返回到与指定监视器关联的其他监视器源模式集对象。从 Windows 7 开始，它可在 DXGK_MONITOR_INTERFACE_V2 界面中使用。

语法

DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET DxgkddiMonitorGetadditionalmonitormodeset;

NTSTATUS DxgkddiMonitorGetadditionalmonitormodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PUINT pNumberModes,
  [out] DEREF_ECOUNT_PPDXGK_TARGETMODE_DETAIL_TIMING ppAdditionalModesSet
)
{...}

参数

[in] hAdapter

标识显示适配器的句柄。 Microsoft DirectX 图形内核子系统以前向 DxgkDdiStartDevice 函数的 DxgkInterface 参数中的显示微型端口驱动程序提供了此句柄。

[in] VideoPresentTargetId

一个整数，用于标识显示适配器上存在的视频目标之一。返回的 ppAdditionalModesSet 其他模式集对象描述了连接到此视频演示目标的监视器上可用的其他监视器源模式集。

[out] pNumberModes

指向一个变量的指针，该变量包含由 VideoPresentTargetId指定的视频演示目标的其他计时模式数。

[out] ppAdditionalModesSet

指向接收指向 DXGK_TARGETMODE_DETAIL_TIMING 结构的指针的变量的指针。该结构描述视频演示目标的其他计时模式，这些模式与显示设备兼容。

返回值

pfnAcquireMonitorSourceModeSet 函数返回以下值之一。

返回代码	描述
STATUS_SUCCESS	函数成功。
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	hAdapter 中提供的句柄无效。
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	VideoPresentTargetId 中提供的标识符无效。
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED	没有连接到 VideoPresentTargetId 标识的视频演示目标的监视器。
STATUS_NOT_FOUND	找不到 VideoPresentTargetId 标识的视频演示目标。