共用方式為


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)
程式庫 D3D9.lib

另請參閱

IDirect3DVolume9

IDirect3DVolume9::UnlockBox