## Printer Device Driver

[prev][next][parent][TOC]

### GplJournalPlayInstance

Description

This function signifies the end of the recording. If you want to call this function multiple times for a page, then for calls 1..n-1 the flag PLAY_ NONDESTRUCTIVE should be used. On the last call, n, the flag PLAY_ DESTRUCTIVE should be used.

Format

    APIRET APIENTRY GplJournalPlayInstance( HJOURNAL  hJournal,

                                            ULONG     ulFlags );

Parameters

hJournal (HJOURNAL) Handle to the journal file instance.

ulFlags (ULONG) This function will perform different actions based on the ulFlags. The ulFlags is a bit vector (individual bits have different meanings). The options are separated into mutually exclusive groups that must have one member set.

PLAY_JOURNAL_BAND Play all bands at this time. The callback function that was defined at GplJournalCreateInstance time will be called after each band has been played.
or
PLAY_JOURNAL_PAGE Plays the journal file once for this page.
PLAY_NONDESTRUCTIVE The DC state will not be altered after the call has been completed.
or
PLAY_DESTRUCTIVE The DC state will now have the final attributes of the page.
PLAY_TOP_TO_BOTTOM Bands are played from the maximum Y value to 0.
or
PLAY_BOTTOM_TO_TOP Bands are played from 0 to the maximum Y value.

Returns

Success TRUE
Failure FALSE