Método IDirect3DTexture9::AddDirtyRect (d3d9helper.h)
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 |