DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET回调函数 (d3dkmddi.h)

项目
02/26/2024

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 标识的视频当前目标。