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

  • Artigo

Adiciona um sujo região 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 sujo a ser adicionada. Especificar NULL expande o sujo região 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, sujo regiões 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 seja 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 sujo automaticamente.

Usar D3DLOCK_NO_DIRTY_UPDATE e especificar explicitamente sujo regiões 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 sujo regiões no recurso. No entanto, as regiões de sujo podem ser expandidas para otimizar o alinhamento.

Requisitos

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

Confira também

IDirect3DTexture9