IDirect3DVolume9：：LockBox 方法 (d3d9helper.h)

  • 项目

锁定卷资源上的一个框。

语法

HRESULT LockBox(
  [out] D3DLOCKED_BOX *pLockedVolume,
  [in]  const D3DBOX  *pBox,
  [in]  DWORD         Flags
);

参数

[out] pLockedVolume

类型： D3DLOCKED_BOX*

指向 D3DLOCKED_BOX 结构的指针，描述锁定的区域。

[in] pBox

类型： const D3DBOX*

指向要锁定的框的指针。 由指向 D3DBOX 结构的指针指定。 为此参数指定 NULL 可锁定整个卷。

[in] Flags

类型： DWORD

描述要执行的锁类型的零个或多个锁定标志的组合。 对于此方法，有效标志为：

  • D3DLOCK_DISCARD
  • D3DLOCK_NO_DIRTY_UPDATE
  • D3DLOCK_NOSYSLOCK
  • D3DLOCK_READONLY
有关标志的说明，请参阅 D3DLOCK。

返回值

类型： HRESULT

如果方法成功，则返回值D3D_OK。 如果 方法失败，则可以D3DERR_INVALIDCALL返回值。

备注

出于性能原因，脏区域仅记录纹理的零级。 在没有D3DLOCK_NO_DIRTY_UPDATE或D3DLOCK_READONLY的情况下调用 IDirect3DVolume9：：LockBox 时，会自动记录脏区域。 有关详细信息，请参阅 IDirect3DDevice9：：UpdateTexture 。

要求

   
目标平台 Windows
标头 d3d9helper.h (包括 D3D9.h)
Library D3D9.lib

另请参阅

IDirect3DVolume9

IDirect3DVolume9：：UnlockBox