EngMarkBandingSurface function (winddi.h)
The EngMarkBandingSurface function marks the specified surface as a banding surface.
Syntax
ENGAPI BOOL EngMarkBandingSurface(
[in] HSURF hsurf
);
Parameters
[in] hsurf
Caller-supplied handle to the surface to mark as a banding surface.
Return value
EngMarkBandingSurface returns TRUE upon success; otherwise it returns FALSE.
Remarks
If a printer graphics DLL uses GDI-managed surfaces, it must call EngMarkBandingSurface if it cannot create a surface (by calling EngCreateBitmap) that is large enough to hold an entire physical page's bitmap. Both EngCreateBitmap and EngMarkBandingSurface should be called from within the printer graphics DLL's DrvEnableSurface function.
The handle supplied for hsurf must be a bitmap handle returned by EngCreateBitmap.
If a printer graphics DLL calls EngMarkBandingSurface, it must define DrvStartBanding and DrvNextBand functions.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows 2000 and later versions of the Windows operating systems. |
| Target Platform | Universal |
| Header | winddi.h (include Winddi.h) |
| Library | Win32k.lib |
| DLL | Win32k.sys |