IDirect3DVolumeTexture9::AddDirtyBox メソッド (d3d9.h)
ボリューム テクスチャ リソースにダーティリージョンを追加します。
構文
HRESULT AddDirtyBox(
[in] const D3DBOX *pDirtyBox
);
パラメーター
[in] pDirtyBox
型: const D3DBOX*
追加するダーティ領域を指定する D3DBOX 構造体へのポインター。 NULL を指定すると、ボリューム テクスチャ全体をカバーするようにダーティ領域が展開されます。
戻り値
種類: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合は、戻り値をD3DERR_INVALIDCALLできます。
注釈
パフォーマンス上の理由から、ダーティ領域はテクスチャのレベル 0 にのみ記録されます。 サブレベルの場合、対応する (スケーリングされた) ボックスもダーティと見なされます。 LockBox がD3DLOCK_NO_DIRTY_UPDATEまたはD3DLOCK_READONLYなしで呼び出されると、ダーティ リージョンが自動的に記録されます。
D3DLOCK_NO_DIRTY_UPDATEを使用し、ダーティリージョンを明示的に指定すると、UpdateTexture の効率を向上させることができます。 このメソッドを使用すると、アプリケーションは、リソースにダーティボックスを指定することで、コピーされるリソースのサブセットを最適化できます。 ただし、配置を最適化するために、ダーティ領域を拡張できます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | d3d9.h (D3D9.h を含む) |
| Library | D3D9.lib |