escape 函数 (wingdi.h)

Escape 函数使应用程序能够访问无法通过 GDI 获取的系统定义设备功能。 应用程序发出的转义调用将被转换并发送到驱动程序。

语法

int Escape(
  [in]  HDC    hdc,
  [in]  int    iEscape,
  [in]  int    cjIn,
  [in]  LPCSTR pvIn,
  [out] LPVOID pvOut
);

参数

[in] hdc

设备上下文的句柄。

[in] iEscape

要执行的转义函数。 此参数必须是备注中列出的预定义转义值之一。 如果应用程序定义了专用转义值,请使用 ExtEscape 函数。

[in] cjIn

lpvInData 参数指向的数据字节数。 这可以是 0。

[in] pvIn

指向指定转义所需的输入结构的指针。

[out] pvOut

指向从此转义接收输出的结构的指针。 如果未返回任何数据,此参数应为 NULL

返回值

如果函数成功,则返回值大于零,但 QUERYESCSUPPORT 打印机转义除外,该转义仅检查实现。 如果未实现转义,则返回值为零。

如果函数失败,则返回值为系统错误代码。

注解

注意 这是一个阻塞或同步函数,可能不会立即返回。 此函数返回的速度取决于运行时因素(例如网络状态、打印服务器配置和打印机驱动程序实现),这些因素在编写应用程序时难以预测。 从管理与用户界面交互的线程调用此函数可能会使应用程序看起来无响应。
 
cbInput 传递 0 的效果将取决于 nEscape 的值以及处理转义的驱动程序。

在原始打印机转义中,只能使用以下内容。

Escape 说明
QUERYESCSUPPORT 确定设备驱动程序是否实现了特定的转义。
PASSTHROUGH 允许应用程序将数据直接发送到打印机。
 

有关打印机转义的信息,请参阅 ExtEscape

使用 StartPage 函数准备打印机驱动程序以接收数据。

要求

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

另请参阅

AbortDoc

DocumentProperties

EndDoc

EndPage

ExtEscape

GetDeviceCaps

打印后台处理程序 API 函数

PrinterProperties

打印

ResetDC

SetAbortProc

StartDoc

StartPage