EngLockSurface

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.