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