Метод IDirect3DTexture9::AddDirtyRect (d3d9helper.h)

Добавляет грязное регион в ресурс текстуры.

Синтаксис

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

Параметры

[in] pDirtyRect

Тип: const RECT*

Указатель на структуру RECT с указанием добавляемого грязное региона. Если указать значение NULL, область грязное расширяется для покрытия всей текстуры.

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. Если метод завершается сбоем, возвращаемое значение можно D3DERR_INVALIDCALL.

Комментарии

По соображениям производительности грязное области записываются только для нулевого уровня текстуры. Для подобласти предполагается, что соответствующий (масштабируемый) прямоугольник или прямоугольник также грязное. Грязные области автоматически записываются при вызове IDirect3DTexture9::LockRect без D3DLOCK_NO_DIRTY_UPDATE или D3DLOCK_READONLY. Область назначения IDirect3DDevice9::UpdateSurface также помечается грязное автоматически.

Использование D3DLOCK_NO_DIRTY_UPDATE и явное указание грязное регионов можно использовать для повышения эффективности IDirect3Device9::UpdateTexture. С помощью этого метода приложения могут оптимизировать копируемый подмножество ресурса, указав грязное регионы в ресурсе. Однако грязное регионы могут быть расширены для оптимизации выравнивания.

Требования

Требование	Значение
Целевая платформа	Windows
Header	d3d9helper.h (включая D3D9.h)
Библиотека	D3D9.lib

См. также раздел

IDirect3DTexture9