ULONG DrvDrawEscape(
IN SURFOBJ *pso, | |
IN ULONG iEsc, | |
IN CLIPOBJ *pco, | |
IN RECTL *prcl, | |
IN ULONG cjIn, | |
IN PVOID *pvIn | |
); |
This entry point serves more than one function call; the particular function depends on the value of the iEsc parameter. The escapes that a device supports are determined by a call to DrvEscape.
Value |
Meaning |
ESC_PASSTHROUGH |
Passes raw device data to the device driver. The number of bytes of raw data is indicated by cjIn. The data is pointed to by pvIn. The return value is the number of bytes written if the function is successful. Otherwise, it is zero, and an error code is logged. |
The return value depends on the function specified by iEsc. The driver should return 0xFFFFFFFF if an unsupported function is called.
This entry point differs from DrvEscape in that a CLIPOBJ structure is provided. This allows a driver to implement its own drawing functions in a windowed environment.
DrvDrawEscape is optional for all drivers.