EngMarkBandingSurface function (winddi.h)

Article
02/22/2024

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