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 |