DevEscape - Parameters

hdc (HDC) - input

Device-context handle.

lCode (LONG) - input

Escape code.

If the device context is of type OD_QUEUED with a PM_Q_STD spool file, some escapes are sent to the presentation driver and others are recorded in the spool file (depending on the escape code). If the device context is of type OD_METAFILE, all escapes are metafiled. If the device context is of any type other than OD_QUEUED (with a PM_Q_STD spool file) or OD_METAFILE, all escapes are sent to the presentation driver.

The description for each standard escape specifies which of these categories the escape falls into.

Devices can define additional escape functions using user lCode values, that have the following ranges:

32 768 through 40 959

Not metafiled and not recorded (sent to presentation driver for PM_Q_STD)
40 960 through 49 151
Metafiled only (sent to presentation driver for PM_Q_STD)
49 152 through 57 343
Metafiled and recorded (not sent to presentation driver) for PM_Q_STD
57 344 through 65 535
Recorded only (not sent to presentation driver for PM_Q_STD).
The following escapes are defined:

DEVESC_QUERYESCSUPPORT

DEVESC_GETSCALINGFACTOR
DEVESC_STARTDOC
DEVESC_ENDDOC
DEVESC_ABORTDOC
DEVESC_NEWFRAME
DEVESC_RAWDATA
DEVESC_QUERYVIOCELLSIZES
DEVESC_SETMODE

lInCount (LONG) - input

Input data count.

Number of bytes of data in the pbInData buffer.

pbInData (PBYTE) - input

The input data required for this escape.

plOutCount (PLONG) - in/out

Output data count.

plOutCount is the number of bytes of data in the pbOutData buffer.

If data is returned in pbOutData, plOutCount is updated to the number of bytes of data returned.

pbOutData (PBYTE) - output

Output data.

pbOutData is a buffer that receives the output from this escape. If plOutCount is null, no data is returned.

lResult (LONG) - returns

Implementation error indicator:

DEVESC_ERROR

Error
DEVESC_NOTIMPLEMENTED
Escape not implemented for specified code
DEV_OK
OK.

---

[Back: DevEscape Return Value - lResult]
[Next: DevEscape - Remarks]