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.

 

Requirements

Minimum supported clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
HeaderWingdi.h (include Windows.h)

See Also

Printing and Print Spooler Overview
Printing and Print Spooler Structures
StartDoc

Send comments about this topic to Microsoft

Build date: 11/16/2009

Tags :


Community Content

zhekov
Do not place \n, \r etc. in lpszDocName
  Make sure your lpszDocName does not contain control characters.
Windows itself works, but a lot of printer drivers fail with such names.
Tags :

Page view tracker