IDirect3DTexture9::AddDirtyRect 方法 (d3d9helper.h)

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

语法

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

参数

[in] pDirtyRect

类型: const RECT*

指向 RECT 结构的指针,指定要添加脏区域。 指定 NULL 可展开脏区域以覆盖整个纹理。

返回值

类型: HRESULT

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

注解

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

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

要求

要求
目标平台 Windows
标头 d3d9helper.h (包括 D3D9.h)
Library D3D9.lib

另请参阅

IDirect3DTexture9