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

另请参阅

DD_SURFACE_LOCAL

EngUnlockDirectDrawSurface