HRESULT DocumentEvent(

__in  HANDLE hPrinter,

__in  HDC hdc,

__in  INT iEsc,

__in  ULONG cbIn,

__in  PVOID pvIn,

__in  ULONG cbOut,

__out PVOID pvOut

);

FUNCTION DocumentEventA ( _

BYVAL hPrinter AS DWORD, _

BYVAL hdc AS DWORD, _

BYVAL iEsc AS LONG, _

BYVAL cbIn AS DWORD, _

BYREF pvIn AS ANY, _

BYVAL cbOut AS DWORD, _

BYREF pvOut AS ANY _

) AS LONG

FUNCTION DocumentEventW ( _

BYVAL hPrinter AS DWORD, _

BYVAL hdc AS DWORD, _

BYVAL iEsc AS LONG, _

BYVAL cbIn AS DWORD, _

BYREF pvIn AS ANY, _

BYVAL cbOut AS DWORD, _

BYREF pvOut AS ANY _

) AS LONG

iEsc不变

事件

DOCUMENTEVENT_ABORTDOC

GDI即将处理对其AbortDoc函数的调用。

DOCUMENTEVENT_CREATEDCPOST

GDI刚刚处理了对其CreateDC或CreateIC函数的调用。

除非已经将IESC设置为DOCUMENTEVENT_CREATEDCPRE的DocumentEvent先前调用，否则不应使用该转义码。

DOCUMENTEVENT_CREATEDCPRE

GDI即将处理其CreateDC或CreateIC函数的调用。

DOCUMENTEVENT_DELETEDC

GDI即将处理对其DeleteDC函数的调用。

DOCUMENTEVENT_ENDDOCPOST

GDI刚刚处理了对其EndDoc函数的调用。

DOCUMENTEVENT_ENDDOCPRE

or DOCUMENTEVENT_ENDDOC

GDI即将处理对其EndDoc函数的调用。

DOCUMENTEVENT_ENDPAGE

GDI即将处理对其EndPage函数的调用。

DOCUMENTEVENT_ESCAPE

GDI即将处理对其ExtEscape函数的调用。

DOCUMENTEVENT_QUERYFILTER

DOCUMENTEVENT_QUERYFILTER事件代表后台处理程序向驱动程序查询驱动程序响应的DOCUMENTEVENT_ XXX事件的列表的机会。此事件是在通过DOCUMENTEVENT_CREATEDCPRE事件的DocumentEvent之前发出的。

DOCUMENTEVENT_RESETDCPOST

GDI刚刚处理了对其ResetDC函数的调用。

除非已经将IESC设置为DOCUMENTEVENT_RESETDCPRE的DocumentEvent先前的调用，否则不应使用该转义码。

DOCUMENTEVENT_RESETDCPRE

GDI即将处理对其ResetDC函数的调用。

DOCUMENTEVENT_STARTDOCPOST

GDI刚刚处理了对其StartDoc函数的调用。

DOCUMENTEVENT_STARTDOCPRE

or DOCUMENTEVENT_STARTDOC

GDI即将处理对其StartDoc函数的调用。

DOCUMENTEVENT_STARTPAGE

GDI即将处理对其StartPage函数的调用。

iEsc不变

pvin内容

DOCUMENTEVENT_ABORTDOC

不曾用过。

DOCUMENTEVENT_CREATEDCPOST

PVIN包含上一次调用此函数的DEVMODE参数中指定的DEVMODE结构的指针的地址，IESC参数设置为DOCUMENTEVENT_CREATEDCPRE。

DOCUMENTEVENT_CREATEDCPRE

PVIN??指向Windows驱动程序开发工具包中记录的DOCEVENT_CREATEDCPRE结构。

DOCUMENTEVENT_DELETEDC

不曾用过。

DOCUMENTEVENT_ENDDOCPOST

不曾用过。

DOCUMENTEVENT_ENDDOCPRE

or DOCUMENTEVENT_ENDDOC

不曾用过。

DOCUMENTEVENT_ENDPAGE

不曾用过。

DOCUMENTEVENT_ESCAPE

PVIN指向Windows驱动程序开发工具包中记录的DOCEVENT_ESCAPE结构。

DOCUMENTEVENT_QUERYFILTER

与DOCUMENTEVENT_CREATEDCPRE相同。

DOCUMENTEVENT_RESETDCPOST

PVIN包含上一次调用此函数的DEVMODE参数中指定的DEVMODE结构的指针地址，{98979699}参数设置为DOCUMENTEVENT_RESETDCPRE。

DOCUMENTEVENT_RESETDCPRE

PVIN包含由ResetDC的呼叫者提供的DEVMODE结构的指针的地址。

DOCUMENTEVENT_STARTDOCPOST

PVIN指向一个LONG，指定由StartDoc返回的打印作业标识符。

DOCUMENTEVENT_STARTDOCPRE

or DOCUMENTEVENT_STARTDOC

PVIN包含由StartDoc的调用者提供的DOCINFO结构的指针的地址。

DOCUMENTEVENT_STARTPAGE

不曾用过。

值

含义

如果IESC是

DOCUMENTEVENT_QUERYFILTER:

指向pvOut的缓冲区指针的大小（以字节为单位）。

如果IESC是

DOCUMENTEVENT_ESCAPE:

用作ExtEscape的cbOutput参数的值。

对于所有其他IESC值：

IESC未使用。

iEsc不变

pvOut内容

DOCUMENTEVENT_CREATEDCPRE

指向驱动程序提供的DEVMODE结构的指针，GDI使用而不是由CreateDC调用者提供的结构。（如果为空，则GDI使用调用者提供的结构。）

DOCUMENTEVENT_ESCAPE

指向缓冲区的指针，用作ExtEscape的lpszOutData参数。

DOCUMENTEVENT_QUERYFILTER

指向缓冲区的指针，其中包含Windows驱动程序开发工具包中记录的DOCEVENT_FILTER结构。

DOCUMENTEVENT_RESETDCPRE

指向驱动程序提供的DEVMODE结构的指针，GDI使用而不是由ResetDC调用者提供的结构。（如果为空，则GDI使用调用者提供的结构。）

所有其他IESC值

不曾用过。

返回值

含义

DOCUMENTEVENT_FAILURE

驱动程序支持IESC标识的转义代码，但发生故障。

DOCUMENTEVENT_SUCCESS

驱动程序成功处理了由IESC标识的转义码。

DOCUMENTEVENT_UNSUPPORTED

司机不支持IESC标识的转义码。

返回值

含义

DOCUMENTEVENT_ABORTDOC

返回值不被使用，不应该被读取。

DOCUMENTEVENT_CREATEDCPOST

返回值不被使用，不应该被读取。

DOCUMENTEVENT_CREATEDCPRE

DOCUMENTEVENT_FAILURE - GDI不会创建设备上下文或信息上下文，并为CreateDC或CreateIC提供返回值0。

DOCUMENTEVENT_DELETEDC

返回值不被使用，不应该被读取。

DOCUMENTEVENT_ENDDOCPOST

返回值不被使用，不应该被读取。

DOCUMENTEVENT_ENDDOCPRE

or DOCUMENTEVENT_ENDDOC

返回值不被使用，不应该被读取。

DOCUMENTEVENT_ENDPAGE

返回值不被使用，不应该被读取。

DOCUMENTEVENT_ESCAPE

返回值不被使用，不应该被读取。

DOCUMENTEVENT_QUERYFILTER

见备注.

DOCUMENTEVENT_RESETDCPOST

返回值不被使用，不应该被读取。

DOCUMENTEVENT_RESETDCPRE

DOCUMENTEVENT_FAILURE - GDI不会重置设备上下文，并为ResetDC提供返回值0。

DOCUMENTEVENT_STARTDOCPOST

DOCUMENTEVENT_FAILURE - GDI调用AbortDoc停止文档，然后为StartDoc提供一个SP_ERROR的返回值。

DOCUMENTEVENT_STARTDOCPRE

or DOCUMENTEVENT_STARTDOC

DOCUMENTEVENT_FAILURE - GDI不启动文档，并为StartDoc提供了一个SP_ERROR的返回值。

DOCUMENTEVENT_STARTPAGE

DOCUMENTEVENT_FAILURE - GDI不启动页面，并为StartPage提供了一个SP_ERROR的返回值。