共用方式為


IDirect3DVolumeTexture9::LockBox 方法 (d3d9helper.h)

鎖定磁片區紋理資源上的方塊。

語法

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

參數

[in] Level

類型: UINT

指定要鎖定的磁片區紋理資源層級。

[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。

備註

基於效能考慮,只會記錄紋理層級零的已變更區域。 呼叫 LockBox 而不需D3DLOCK_NO_DIRTY_UPDATE或D3DLOCK_READONLY時,系統會自動記錄已變更的區域。 如需詳細資訊,請參閱 UpdateTexture

需求

   
目標平台 Windows
標頭 d3d9helper.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DVolumeTexture9

UnlockBox