MXDC_S0PAGE_PASSTHROUGH_ESCAPE_T结构

  • 项目

MXDC_S0PAGE_PASSTHROUGH_ESCAPE_T结构是与MXDC_S0PAGE_DATA_T结构串联的MXDC_ESCAPE_HEADER_T结构。

语法

typedef struct tagMxdcS0PagePassthroughEscape {
  MXDC_ESCAPE_HEADER_T mxdcEscape;
  MXDC_S0PAGE_DATA_T   xpsS0PageData;
} MXDC_S0PAGE_PASSTHROUGH_ESCAPE_T, *P_MXDC_S0PAGE_PASSTHROUGH_ESCAPE_T;

成员

mxdcEscape

其 opCode 成员设置为 MXDCOP_SET_S0PAGE 的 MXDC_ESCAPE_HEADER_T 结构。

xpsS0PageData

表示 XPS 文档页的 MxdcS0PageData 结构。

备注

使用 MXDC_ESCAPE 转义调用 ExtEscape 函数时，此结构在 extEscape 函数的 lpszInData 参数中传递，并且MXDCOP_SET_S0PAGE MXDC_ESCAPE_HEADER_T 结构的 opCode 成员。 结果是 Microsoft XML 文档转换器 (MXDC) 将页面传递到打印机，而不对其进行处理。

按如下所示为转义分配内存，根据需要设置字段，然后调用 ExtEscape。

// Compute size of buffer required adding the
//  size of the escape structure to the size
//  of the resource data buffer.
SIZE_T iTotalDataSize = sizeof(MXDC_S0PAGE_PASSTHROUGH_ESCAPE_T) + 
                        iS0PageDataSize - 1;

// Allocate the memory buffer.
P_MXDC_S0PAGE_PASSTHROUGH_ESCAPE_T pS0PageEscapeData = 
                        (P_MXDC_S0PAGE_PASSTHROUGH_ESCAPE_T)HeapAlloc(
                            GetProcessHeap(),
                            0,
                            iTotalDataSize);

对 ExtEscape 的调用必须在对 StartPage 的调用和 对 EndPage 的调用之间。

调用应用程序负责验证 XPS 文档页的 XML。

如果在使用 MXDCOP_SET_S0PAGE 调用 ExtEscape 之前，先使用 MXDCOP_SET_S0PAGE_RESOURCE 作为页面上每个资源的 opCode 来调用 ExtEscape，则流式处理消耗会更高效。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 [仅限桌面应用]
标头
Mxdc.h

另请参阅

打印

打印后台处理程序 API 结构

GDI 打印机转义函数

ExtEscape

MXDC_ESCAPE