GreStartJournalFile

GreStartJournalFile starts the journaling process.

This function is supported by the graphics engine.

Syntax

GreStartJournalFile(hdc, hJournal, pInstance, lFunction)

Parameters

hdc (HDC) - input

Device context handle.

hJournal (ULONG) - input

Journal file handle.

pInstance (PVOID) - input

Pointer to instance data.

lFunction (ULONG) - input

High-order WORD=flags; low-order WORD=NGreStartJournalFile.

Return Code

fSuccess (BOOL) - returns

Return codes.

On completion, the handling routine must return BOOLEAN (fSuccess).

• TRUE Successful
• FALSE Error

Possible Errors Detected: When an error is detected, the graphics engine calls WinSetErrorInfo to post the condition. Reasons for failure of this function include:

• PMERR_BASE_ERROR
• PMERR_BITMAP_IS_SELECTED
• PMERR_COORDINATE_OVERFLOW
• PMERR_DEV_FUNC_NOT_INSTALLED
• PMERR_EXCEEDS_MAX_SEG_LENGTH
• PMERR_HBITMAP_BUSY
• PMERR_HDC_BUSY
• PMERR_HUGE_FONTS_NOT_SUPPORTED
• PMERR_INSUFFICIENT_MEMORY
• PMERR_INV_BACKGROUND_COL_ATTR
• PMERR_INV_BACKGROUND_MIX_ATTR
• PMERR_INV_BITMAP_DIMENSION
• PMERR_INV_CHAR_DIRECTION_ATTR
• PMERR_INV_CHAR_MODE_ATTR
• PMERR_INV_CODEPAGE
• PMERR_INV_COLOR_ATTR
• PMERR_INV_COORD_SPACE
• PMERR_INV_COORDINATE
• PMERR_INV_DC_DATA
• PMERR_INV_DC_TYPE
• PMERR_INV_DRIVER_NAME
• PMERR_INV_HBITMAP
• PMERR_INV_HDC
• PMERR_INV_HJOURNAL
• PMERR_INV_HRGN
• PMERR_INV_ID
• PMERR_INV_IN_AREA
• PMERR_INV_IN_PATH
• PMERR_INV_INFO_TABLE
• PMERR_INV_LENGTH_OR_COUNT
• PMERR_INV_LINE_TYPE_ATTR
• PMERR_INV_METAFILE
• PMERR_INV_MIX_ATTR
• PMERR_INV_PATTERN_REF_PT_ATTR
• PMERR_INV_PATTERN_SET_ATTR
• PMERR_INV_PATTERN_SET_FONT
• PMERR_INV_RECT
• PMERR_INV_REGION_CONTROL
• PMERR_INV_SCAN_START
• PMERR_JFILE_BUSY
• PMERR_RAM_JNL_FILE_TOO_SMALL

Refer to the "Error Explanations" section of the Presentation Manager Programming Reference for further explanation.

Remarks

This function opens the previously created journal file and turns ON the COM_RECORDING bit. Subsequent calls to this DC drop through [GreAccumulateJournalFile] until GreStopJournalFile is called.

Note

The COM_DRAW bit is turned OFF until GreStopJournalFile is called.