IDirect3DVolumeTexture9：：AddDirtyBox 方法 (d3d9.h)

将脏区域添加到卷纹理资源。

语法

HRESULT AddDirtyBox(
  [in] const D3DBOX *pDirtyBox
);

[in] pDirtyBox

类型： const D3DBOX*

指向 D3DBOX 结构的指针，指定要添加脏区域。指定 NULL 会扩展脏区域以覆盖整个体积纹理。

类型： HRESULT

如果该方法成功，则返回值D3D_OK。如果方法失败，则可以D3DERR_INVALIDCALL返回值。

出于性能原因，仅针对纹理的零级记录脏区域。对于子级别，假定也脏相应的 (缩放) 框。在没有D3DLOCK_NO_DIRTY_UPDATE或D3DLOCK_READONLY的情况下调用 LockBox 时，会自动记录脏区域。

使用D3DLOCK_NO_DIRTY_UPDATE并显式指定脏区域可以提高 UpdateTexture 的效率。使用此方法，应用程序可以通过在资源上指定脏框来优化复制的资源子集。但是，可以扩展脏区域以优化对齐方式。