IDirect3DVolumeTexture9::AddDirtyBox メソッド (d3d9helper.h)

ボリューム テクスチャ リソースにダーティリージョンを追加します。

構文

HRESULT AddDirtyBox(
  [in] const D3DBOX *pDirtyBox
);

パラメーター

[in] pDirtyBox

型: const D3DBOX*

追加するダーティ領域を指定する D3DBOX 構造体へのポインター。 NULL を指定すると、ボリューム テクスチャ全体をカバーするようにダーティ領域が展開されます。

戻り値

型: HRESULT

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

解説

パフォーマンス上の理由から、ダーティ領域はテクスチャのレベル 0 に対してのみ記録されます。 サブレベルの場合、対応する (スケーリングされた) ボックスもダーティと見なされます。 D3DLOCK_NO_DIRTY_UPDATEやD3DLOCK_READONLYなしで LockBox が呼び出されると、ダーティ リージョンが自動的に記録されます。

updateTexture の効率を向上させるために、D3DLOCK_NO_DIRTY_UPDATEを使用し、ダーティリージョンを明示的に指定できます。 このメソッドを使用すると、アプリケーションは、リソースにダーティ ボックスを指定することで、コピーされるリソースのサブセットを最適化できます。 ただし、ダーティ領域を拡張して配置を最適化できます。

要件

関連項目

IDirect3DVolumeTexture9