SplStdStart

SplStdStart starts the recording of GPI and DevEscape calls as a metafile in the PM_Q_STD buffer.

Syntax

SplStdStart(hdc)

Parameters

hdc (HDC) - input

The device context handle.

Return Code

fSuccess (BOOL) - returns

Return codes.

This function returns BOOLEAN (fSuccess):

• TRUE Success
• FALSE Error

Remarks

The calls are still processed by the system and passed on to the graphics engine and hardcopy driver as calls to the relevant Grexxx functions.

The hardcopy driver's Escape routine usually calls SplStdStart when DEVESC_STARTDOC is received. Some previous versions of presentation drivers made this call from the CompleteOpenDC routine to accommodate applications that did not call DevEscape(DEVESC_STARTDOC) at the start of the document.

#include <os2.h>

HDC     hdc;       /*  The device context handle. */
BOOL    fSuccess;  /*  Return codes. */

fSuccess = SplStdStart(hdc);