IDirect3DVolumeTexture9::AddDirtyBox 方法 (d3d9.h)

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

语法

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

参数

[in] pDirtyBox

类型: const D3DBOX*

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

返回值

类型: HRESULT

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

注解

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

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

要求

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

另请参阅

IDirect3DVolumeTexture9