Метод IDirect3DVolumeTexture9::AddDirtyBox (d3d9helper.h)

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

Синтаксис

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

Параметры

[in] pDirtyBox

Тип: const D3DBOX*

Указатель на структуру D3DBOX с указанием добавляемого региона грязное. Если указать значение NULL, область грязное будет охватывать всю текстуру тома.

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

Тип: HRESULT

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

Комментарии

Из соображений производительности грязное области записываются только для нулевого уровня текстуры. Для вложенных значений предполагается, что соответствующий (масштабируемый) прямоугольник также грязное. Грязные области автоматически записываются при вызове LockBox без D3DLOCK_NO_DIRTY_UPDATE или D3DLOCK_READONLY.

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

Требования

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

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

IDirect3DVolumeTexture9