EngLockDirectDrawSurface 函数 (winddi.h)

EngLockDirectDrawSurface 函数锁定 DirectDraw 图面的内核模式句柄。

语法

ENGAPI PDD_SURFACE_LOCAL EngLockDirectDrawSurface(
  [in] HANDLE hSurface
);

[in] hSurface

要锁定的图面的句柄。

EngLockDirectDrawSurface 返回指向 DD_SURFACE_LOCAL 结构的指针，该结构描述成功后的表面信息。否则，它返回空指针。

EngLockDirectDrawSurface 允许驱动程序编写器锁定 DirectDraw 图面。锁定句柄可以保证同步行为，并防止句柄被系统中的其他线程删除。

目前，驱动程序仅从 Direct3D 纹理接口接收 DirectDraw 表面句柄。因此，只有执行纹理的驱动程序需要锁定纹理图面。

完成纹理后，驱动程序必须通过调用 EngUnlockDirectDrawSurface 释放锁定的句柄。

要求	值
最低受支持的客户端	适用于 Windows 2000 及更高版本的 Windows 操作系统。
目标平台	通用
标头	winddi.h (包括 Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys