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 宣言