Método IDirect3DTexture9::AddDirtyRect (d3d9helper.h)

Adiciona uma região suja a um recurso de textura.

Sintaxe

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

Parâmetros

[in] pDirtyRect

Tipo: const RECT*

Ponteiro para uma estrutura RECT , especificando a região suja a ser adicionada. Especificar NULL expande a região suja para cobrir toda a textura.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser D3DERR_INVALIDCALL.

Comentários

Por motivos de desempenho, as regiões sujas são registradas apenas para o nível zero de uma textura. Para subnível, supõe-se que o retângulo ou caixa correspondente (dimensionado) também esteja sujo. Regiões sujas são registradas automaticamente quando IDirect3DTexture9::LockRect é chamado sem D3DLOCK_NO_DIRTY_UPDATE ou D3DLOCK_READONLY. A superfície de destino de IDirect3DDevice9::UpdateSurface também é marcada como suja automaticamente.

Usar D3DLOCK_NO_DIRTY_UPDATE e especificar explicitamente regiões sujas pode ser usado para aumentar a eficiência de IDirect3DDevice9::UpdateTexture. Usando esse método, os aplicativos podem otimizar qual subconjunto de um recurso é copiado especificando regiões sujas no recurso. No entanto, as regiões sujas podem ser expandidas para otimizar o alinhamento.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d9helper.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

IDirect3DTexture9