ResetDCA 函数 (wingdi.h)

ResetDC 函数使用指定的信息更新指定的打印机或绘图器设备上下文(DC)。

语法

HDC ResetDCA(
  [in] HDC            hdc,
  [in] const DEVMODEA *lpdm
);

参数

[in] hdc

要更新的 DC 的句柄。

[in] lpdm

指向包含有关新 DC 的信息的 DEVMODE 结构的指针。

返回值

如果函数成功,则返回值是原始 DC 的句柄。

如果函数失败,则返回值 NULL

言论

当窗口收到 WM_DEVMODECHANGE 消息时,应用程序通常会使用 ResetDC 函数。 ResetDC 还可用于在打印文档时更改纸张方向或纸箱。

ResetDC 函数不能用于更改驱动程序名称、设备名称或输出端口。 当用户更改端口连接或设备名称时,应用程序必须删除原始 DC,并使用新信息创建新的 DC。

应用程序可以将信息 DC 传递给 ResetDC 函数。 在这种情况下,ResetDC 将始终返回打印机 DC。

ICM:hdc 参数指定的 DC 的颜色配置文件将基于 DEVMODE 结构 lpInitData 成员中包含的信息重置。

注意

wingdi.h 标头将 ResetDC 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 wingdi.h (包括 Windows.h)
Gdi32.lib
DLL Gdi32.dll

另请参阅

DEVMODE

设备上下文函数

设备上下文概述

DeviceCapabilities

转义