Microsoft DirectX 8.0 (Visual Basic)

Direct3DTexture8.AddDirtyRect

テクスチャ リソースにダーティー領域を追加する。

object.AddDirtyRect( _ 
    DirtyRect As Any)

指定項目

object
Direct3DTexture8 オブジェクトを表すオブジェクト式。
DirtyRect
RECT 型。追加するダーティー領域を指定する。ByVal 0 を指定すると、ダーティー領域が拡大してテクスチャ全体を覆う。

エラー コード

失敗した場合はエラーが発生し、Err.NumberD3DERR_INVALIDCALL が設定される。

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

リソースのダーティー領域を指定することで、コピーされるリソースのサブセットを最適化できる。

パフォーマンスの理由によって、ダーティーな範囲はテクスチャのレベルゼロに対して記録されるのみである。サブレベルについては、対応する (スケールされた) 矩形またはボックスもダーティーであると仮定される。D3DLOCK_NO_DIRTY_UPDATE または D3DLOCK_READONLY なしで LockRectLockBox が呼び出されたとき、ダーティーな範囲は自動的に記録される。また CopyRects 呼び出しの宛先サーフェスはダーティーとしてマークされる。