DXGKDDI_MONITORSOURCEMODESET_ADDMODE回调函数 (d3dkmddi.h)

  • 项目

pfnAddMode 函数将监视源模式添加到指定的监视源模式集对象。

语法

DXGKDDI_MONITORSOURCEMODESET_ADDMODE DxgkddiMonitorsourcemodesetAddmode;

NTSTATUS DxgkddiMonitorsourcemodesetAddmode(
  [in] IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [in] IN_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo
)
{...}

参数

[in] hMonitorSourceModeSet

监视源模式集对象的句柄。 显示微型端口驱动程序之前通过调用 Monitor 接口的 pfnAcquireMonitorSourceModeSet 函数来获取此句柄。

[in] pMonitorSourceModeInfo

指向描述监视器源模式 的D3DKMDT_MONITOR_SOURCE_MODE 结构的指针。 显示微型端口驱动程序以前通过调用 pfnCreateNewModeInfo 获取此结构。

返回值

pfnAddMode 函数返回以下值之一。

返回代码 说明
STATUS_SUCCESS 函数成功。
STATUS_NO_MEMORY 函数失败，因为它无法分配足够的内存。
STATUS_GRAPHICS_INVALID_MONITOR_SOURCE_MODE pMonitorSourceModeInfo 中提供的信息无效。
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET hMonitorSourceModeSet 中提供的句柄无效。
STATUS_GRAPHICS_INVALID_FREQUENCY pMonitorSourceModeInfo 中提供的频率信息无效。
STATUS_GRAPHICS_INVALID_ACTIVE_REGION pMonitorSourceModeInfo 中提供的活动区域无效。
STATUS_GRAPHICS_INVALID_TOTAL_REGION pMonitorSourceModeInfo 中提供的总区域无效。
STATUS_GRAPHICS_MODE_ALREADY_IN_MODE_SET 模式集已包含与 pMonitorSourceModeInfo 中提供的模式相同的模式。
STATUS_GRAPHICS_MODE_ID_MUST_BE_UNIQUE pMonitorSourceModeInfo-Id> 中提供的标识符已用于模式集中的另一种模式。
STATUS_GRAPHICS_RESOURCES_NOT_RELATED pMonitorSourceModeInfo 指向的结构不是为了添加到 hMonitorSourceModeSet 指定的模式集而创建的。

注解

如果 pMonitorSourceModeInfo-Preference> 等于 D3DKMDT_MP_PREFERRED，则新添加的模式将成为模式集的首选模式。

要求

要求 值
最低受支持的客户端 Windows Vista
目标平台 桌面
标头 d3dkmddi.h (包括 D3dkmddi.h)
IRQL PASSIVE_LEVEL

另请参阅

pfnCreateNewModeInfo