次の方法で共有


IDirect3DVolumeTexture9::LockBox

ボリューム テクスチャー リソース上のボックスをロックします。

HRESULT 
LockBox(
  UINT Level,
  D3DLOCKED_BOX * pLockedVolume,
  CONST D3DBOX * pBox,
  DWORD Flags
);

パラメータ

  • Level
    ロックするボリューム テクスチャー リソースのレベルを指定します。
  • pLockedVolume
    ロックされた領域を表す D3DLOCKED_BOX 構造体へのポインター。
  • pBox
    ロックするボリュームへのポインター。このパラメーターには、D3DBOX 構造体へのポインターを指定します。このパラメーターに NULL を指定した場合、そのボリューム レベル全体がロックされます。
  • Flags
    実行するロックのタイプを指定する、0 個以上のロッキング フラグの組み合わせ。このメソッドに使用できるフラグを次に示します。
    • D3DLOCK_DISCARD
    • D3DLOCK_NO_DIRTY_UPDATE
    • D3DLOCK_NOSYSLOCK
    • D3DLOCK_READONLY フラグについては、「D3DLOCK」を参照してください。

戻り値

メソッドが成功した場合は、D3D_OK を返します。失敗した場合は、D3DERR_INVALIDCALL を返します。

解説 

パフォーマンス上の理由から、ダーティ領域はレベル ゼロのテクスチャーについてのみ記録されます。D3DLOCK_NO_DIRTY_UPDATE または D3DLOCK_READONLY なしで IDirect3DVolumeTexture9::LockBox を呼び出した場合、ダーティ領域も自動的に記録されます。詳細については、「IDirect3DDevice9::UpdateTexture」を参照してください。

要件

ヘッダー: D3D9.h 宣言

関連項目

IDirect3DVolumeTexture9::UnlockBox