SURFOBJ *EngLockSurface(
| IN HSURF hsurf | |
| ); |
EngLockSurface creates a user object for a given surface. This function gives drivers access to surfaces they create.
Parameters
hsurf
Handle that identifies the surface to lock.
Return Value
The return value is a pointer to a SURFOBJ structure if the function is successful. Otherwise, it is null.
Comments
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.