IDirect3DCubeTexture9：：AddDirtyRect 方法 (d3d9helper.h)

将脏区域添加到多维数据集纹理资源。

语法

HRESULT AddDirtyRect(
  [in] D3DCUBEMAP_FACES FaceType,
  [in] const RECT       *pDirtyRect
);

[in] FaceType

D3DCUBEMAP_FACES枚举类型的成员，用于标识多维数据集映射面。

[in] pDirtyRect

类型： const RECT*

指向 RECT 结构的指针，指定脏区域。指定 NULL 将展开脏区域以覆盖整个立方体纹理。

类型： HRESULT

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

出于性能原因，仅针对纹理的零级记录脏区域。对于子级别，假定相应的 (缩放) 矩形或框也脏。在没有D3DLOCK_NO_DIRTY_UPDATE或D3DLOCK_READONLY的情况下调用 IDirect3DCubeTexture9：：LockRect 时，会自动记录脏区域。 IDirect3DDevice9：：UpdateSurface 的目标图面也会自动标记为脏。

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