Метод 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 |