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