CreateDC功能通过使用指定的名称为设备创建设备上下文(DC)。
HDC CreateDC(
LPCTSTR 【lpszDriver】, | //指向驱动程序名称的字符串指针 |
LPCTSTR 【lpszDevice】, | //指向设备名称的字符串指针 |
LPCTSTR 【lpszOutput】, | // 不使用;设置为NULL |
CONST DEVMODE *【lpInitData】 | //指向可选打印机数据的指针 |
); |
参数
【lpszDriver】
为早期版本的Windows编写的应用程序使用此参数指定设备驱动程序的文件名(无扩展名)。
Windows 95:在基于Win32的应用程序中,此参数将被忽略,并且应为NULL,但有一个例外:您可以通过指定以空值终止的字符串“DISPLAY”来获取显示设备上下文。如果此参数为“DISPLAY”,则所有其他参数必须为NULL。
指向一个空值终止的字符串,指定显示驱动程序的“DISPLAY”,或通常为“WINSPOOL”的打印机驱动程序的名称。
【lpszDevice】
指向一个空值终止的字符串,指定正在使用的特定输出设备的名称,如Print Manager(例如“Epson FX-80”)所示。它不是打印机型号名称。必须使用【lpszDevice】参数。
【lpszOutput】
此参数被忽略。不要在Win32应用程序中使用它。基于Win32的应用程序应将此参数设置为NULL。它存在于为早期版本的Windows编写的应用程序提供兼容性。有关详细信息,请参阅以下备注部分。
【lpInitData】
指向DEVMODE结构,其中包含设备驱动程序的特定于设备的初始化数据。DocumentProperties函数检索为指定设备填充的此结构。如果设备驱动程序要使用用户指定的默认初始化(如果有),则【lpInitData】参数必须为NULL。
返回值
如果函数成功,则返回值是指定设备的设备上下文的句柄。
如果函数失败,返回值为NULL。
备注
为早期版本的Windows编写的应用程序使用【lpszOutput】参数指定端口名称或打印到文件。基于Win32的应用程序不需要指定端口名称。通过使用DOCINFO结构lpszOutput成员指定输出文件名路径的StartDoc结构调用StartDoc函数,可以将基于Win32的应用程序打印到文件中。
当您不再需要设备上下文时,请调用DeleteDC功能将其删除。
也可以看看