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.