background image
Functional specification
26
CDE/Motif PST
CDEnext
2.8
XpStartJob - XpEndJob - XpCancelJob
2.8.1
Short Description
Indicates the beginning and ending of a single print job.
2.8.2
Long Description
NAME
XpStartJob - start a print job
XpEndJob - end a print job
XpCancelJob - cancel a print job
SYNOPSIS
#include <X11/extensions/Print.h>
void XpStartJob(
Display
*display,
XPSaveData
save_data
)
void XpEndJob (
Display
*display
)
void XpCancelJob (
Display
*display
)
ARGUMENTS
display
Specifies a pointer to the
Display
structure; returned from
XOpenDisplay
.
save_data
If set to
XPSpool
, then the document data is typically sent to a spooler. If
XPGetData
, then the document data is made available to
XpGetDocumentData
.
RETURN VALUE
None.
DESCRIPTION
XpStartJob
signals the beginning of a new print job.
If
save_data
is
XPGetData
, then the X Print Server buffers the document output for retrieval by
XpGetDocumentData
. The X Print Server will block the client's
display
connection if the output
buffer grows too large, either because
XpGetDocumentData
has not been called, or
XpGetDocumentData
has been called but is not consuming document data fast enough.