Microsoft DirectX 8.0 (Visual Basic)

Direct3DVolumeTexture8.AddDirtyBox

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

object.AddDirtyBox( _ 
    DirtyBox As Any)

指定項目

object
Direct3DVolumeTexture8 オブジェクトを表すオブジェクト式。
DirtyBox
D3DBOX 型。追加するダーティー領域を指定する。ByVal 0 を指定すると、ボリューム テクスチャ全体をロックする。

エラー コード

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

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

注意

リソースのボックスを指定することで、コピーされるリソースのサブセットを最適化できる。ただし、ダーティー領域は、アラインメントを最適化するために拡大される場合がある。

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