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 |
|
|
Library |
|
See also
Send comments about this topic to Microsoft
Build date: 11/29/2012
