EngMarkBandingSurface

The EngMarkBandingSurface function marks the specified surface as a banding surface.

BOOL
  EngMarkBandingSurface(
    IN HSURF  hsurf
    );

Parameters

hsurf

Caller-supplied handle to the surface to mark as a banding surface.

Return Value

The return value is always TRUE.

Headers

Declared in winddi.h. Include winddi.h.

Comments

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.

See Also

EngCreateBitmap, DrvEnableSurface, DrvStartBanding, DrvNextBand