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

実行するロックの種類を記述する 0 個以上のロック フラグの組み合わせ。 このメソッドの有効なフラグは次のとおりです。

• D3DLOCK_DISCARD
• D3DLOCK_NO_DIRTY_UPDATE
• D3DLOCK_NOSYSLOCK
• D3DLOCK_READONLY

フラグの説明については、「 D3DLOCK」を参照してください。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合は、戻り値をD3DERR_INVALIDCALLできます。

解説

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

要件

対象プラットフォーム	Windows
ヘッダー	d3d9helper.h (D3D9.h を含む)
Library	D3D9.lib

関連項目

IDirect3DVolumeTexture9

UnlockBox