DOCINFO structure

The DOCINFO structure contains the input and output file names and other information used by the StartDoc function.

Syntax


typedef struct {
  int     cbSize;
  LPCTSTR lpszDocName;
  LPCTSTR lpszOutput;
  LPCTSTR lpszDatatype;
  DWORD   fwType;
} DOCINFO, *LPDOCINFO;

Members

cbSize

The size, in bytes, of the structure.

lpszDocName

Pointer to a null-terminated string that specifies the name of the document.

lpszOutput

Pointer to a null-terminated string that specifies the name of an output file. If this pointer is NULL, the output will be sent to the device identified by the device context handle that was passed to the StartDoc function.

lpszDatatype

Pointer to a null-terminated string that specifies the type of data used to record the print job. The legal values for this member can be found by calling EnumPrintProcessorDatatypes and can include such values as raw, emf, or XPS_PASS. This member can be NULL. Note that the requested data type might be ignored.

fwType

Specifies additional information about the print job. This member must be zero or one of the following values.

ValueMeaning
DI_APPBANDINGApplications that use banding should set this flag for optimal performance during printing.
DI_ROPS_READ_DESTINATIONThe application will use raster operations that involve reading from the destination surface.

 

Examples

For a sample program that uses this structure, see How To: Print Using the GDI Print API.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

See also

Printing
Print Spooler API Structures
StartDoc

 

 

Community Additions

ADD
Show:
© 2015 Microsoft