Метод IDirect3DVolumeTexture9::AddDirtyBox (d3d9.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 | d3d9.h (включая D3D9.h) |
| Библиотека | D3D9.lib |