IDirect3DCubeTexture9::AddDirtyRect 方法 (d3d9.h)
将脏区域添加到多维数据集纹理资源。
语法
HRESULT AddDirtyRect(
[in] D3DCUBEMAP_FACES FaceType,
[in] const RECT *pDirtyRect
);
参数
[in] FaceType
类型: D3DCUBEMAP_FACES
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 的效率。 使用此方法,应用程序可以通过在资源上指定脏区域来优化复制的资源子集。 但是,可以扩展脏区域以优化对齐方式。
要求
目标平台 | Windows |
标头 | d3d9.h (包括 D3D9.h) |
Library | D3D9.lib |
请参阅
IDirect3DCubeTexture9::GetLevelDesc