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
);
Parameters
hsurf
Handle to the surface to be locked.
Return value
EngLockSurface returns a pointer to a SURFOBJ structure if the function is successful. Otherwise, this function returns NULL.
Remarks
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.
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 |