Export (0) Print
Expand All
Expand Minimize

EngLockDirectDrawSurface function

The EngLockDirectDrawSurface function locks the kernel-mode handle of a DirectDraw surface.

Syntax


PDD_SURFACE_LOCAL EngLockDirectDrawSurface(
  _In_  HANDLE hSurface
);

Parameters

hSurface [in]

Handle to the surface to be locked.

Return value

EngLockDirectDrawSurface returns a pointer to a DD_SURFACE_LOCAL structure that describes the surface information upon success. Otherwise, it returns a NULL pointer.

Remarks

EngLockDirectDrawSurface allows driver writers to lock DirectDraw surfaces. Locking the handle guarantees synchronized behavior and preserves the handle from being deleted by other threads in the system.

Currently, the driver receives DirectDraw surface handles only from the Direct3D texturing interface. Consequently, only drivers that perform texturing need to lock texture surfaces.

Upon completion of texturing, the driver must release the locked handle by calling EngUnlockDirectDrawSurface.

Requirements

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

EngUnlockDirectDrawSurface
DD_SURFACE_LOCAL

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft