Microsoft DirectX 8.0 (Visual Basic) |
ボリューム テクスチャ リソースにダーティー領域を追加する。
object.AddDirtyBox( _ DirtyBox As Any)
失敗した場合はエラーが発生し、Err.Number に D3DERR_INVALIDCALL が設定される。
エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。
リソースのボックスを指定することで、コピーされるリソースのサブセットを最適化できる。ただし、ダーティー領域は、アラインメントを最適化するために拡大される場合がある。
パフォーマンスの理由によって、ダーティーな範囲はテクスチャのレベルゼロに対して記録されるのみである。サブレベルについては、対応する(スケールされた) 矩形またはボックスもダーティーであると仮定される。D3DLOCK_NO_DIRTY_UPDATE または D3DLOCK_READONLY なしで LockRect か LockBox が呼び出されたとき、ダーティーな範囲は自動的に記録される。また CopyRects 呼び出しの宛先サーフェスはダーティーとしてマークされる。