EngLockSurface function (winddi.h)

The EngLockSurface function creates a user object for a given surface. This function gives drivers access to surfaces they create.

Syntax

ENGAPI SURFOBJ * EngLockSurface(
  HSURF hsurf
);

hsurf

Handle to the surface to be locked.

EngLockSurface returns a pointer to a SURFOBJ structure if the function is successful. Otherwise, this function returns NULL.

This function gives drivers access to surfaces they create.

The driver is responsible for unlocking the surface when it no longer needs it. Surfaces should be locked only for very short periods of time.

Use the EngUnlockSurface function to unlock the surface.

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