EngMarkBandingSurface function

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

Syntax


BOOL EngMarkBandingSurface(
  _In_ HSURF hsurf
);

Parameters

hsurf [in]

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

Target platform

Universal

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Winddi.h (include Winddi.h)

Library

Win32k.lib

DLL

Win32k.sys

See also

EngCreateBitmap
DrvEnableSurface
DrvStartBanding
DrvNextBand

 

 

Send comments about this topic to Microsoft

Show: