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 |