IDirect3DVolumeTexture9::LockBox メソッド
IDirect3DVolumeTexture9::LockBox メソッド
ボリューム テクスチャ リソース上のボックスをロックする。
構文
HRESULT LockBox(
UINT Level,
D3DLOCKED_BOX *pLockedVolume,
const D3DBOX *pBox,
DWORD Flags
);
パラメータ
Level
[in] ロックするボリューム テクスチャ リソースのレベルを指定する。pLockedVolume
[out] ロック済みの領域を記述する D3DLOCKED_BOX 構造体へのポインタ。pBox
[in] ロックするボリュームへのポインタ。このパラメータは、D3DBOX 構造体へのポインタで指定される。このパラメータに NULL を指定すると、ボリューム レベル全体がロックされる。Flags
[in] 実行するロックの種類を記述する、0 個以上のロッキング フラグの組み合わせ。このメソッドに使用できるフラグは次のとおり。- D3DLOCK_DISCARD
- D3DLOCK_NO_DIRTY_UPDATE
- D3DLOCK_NO_SYSLOCK
- D3DLOCK_READONLY
フラグについては、「D3DLOCK」を参照すること。
戻り値
成功した場合は、D3D_OK を返す。
失敗した場合は、D3DERR_INVALIDCALL を返す。
注意
パフォーマンス上の理由から、ダーティー領域はテクスチャのレベル 0 についてのみ記録する。D3DLOCK_NO_DIRTY_UPDATE または D3DLOCK_READONLY を指定せずに IDirect3DVolumeTexture9::LockBox を呼び出すと、ダーティー領域が自動的に記録される。詳細については、「IDirect3DDevice9::UpdateTexture」を参照すること。
参照