MXDC_XPS_S0PAGE_RESOURCE_T structure

The MXDC_XPS_S0PAGE_RESOURCE_T structure holds information about a resource, such as an image or font, that is associated with an XPS document page, and is to be passed to the Microsoft XPS Document Converter (MXDC) output file.

Syntax

typedef struct tagMxdcXpsS0PageResource {
  DWORD dwSize;
  DWORD dwResourceType;
  BYTE  szUri[MAX_PATH];
  DWORD dwDataSize;
  BYTE  bData[1];
} MXDC_XPS_S0PAGE_RESOURCE_T, *P_MXDC_XPS_S0PAGE_RESOURCE_T;

Members

dwSize

The total size of this structure and the resource to which it points.

dwResourceType

A value of type MXDC_S0_PAGE_ENUMS indicating the type of resource, such as TIFF image or TrueType font.

szUri

The URI of the resource. This cannot be more than 260 bytes.

dwDataSize

The size of the resource in bytes.

bData

The data of the resource in an array of bytes with size 1 + the size of the resource.

Remarks

This structure is appended to a MXDC_ESCAPE_HEADER_T structure (that has its opCode set to MXDCOP_SET_S0PAGERESOURCE) to make an MXDC_S0PAGE_RESOURCE_ESCAPE_T structure. The resulting MXDC_S0PAGE_RESOURCE_ESCAPE_T structure is then passed in the lpszInData parameter of the ExtEscape function that it is called with the MXDC_ESCAPE escape. The effect is to send the resource to the MXDC for conversion and to be written to the output file.

The call to ExtEscape must be between a call to StartPage and a call to EndPage; however there can be more than one such calls between the calls to StartPage and EndPage.

Streaming consumption is more efficient if you call ExtEscape with the MXDCOP_SET_S0PAGE_RESOURCE opCode for each resource on the page before you call ExtEscape with the MXDCOP_SET_S0PAGE opCode.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Header
Mxdc.h

See also

Printing

Print Spooler API Structures

GDI Printer Escape Functions

ExtEscape

MXDC_ESCAPE