Método IDirect3DVolumeTexture9::AddDirtyBox (d3d9helper.h)
Adiciona uma região sujo a um recurso de textura de volume.
Sintaxe
HRESULT AddDirtyBox(
[in] const D3DBOX *pDirtyBox
);
Parâmetros
[in] pDirtyBox
Tipo: const D3DBOX*
Ponteiro para uma estrutura D3DBOX, especificando a sujo região a ser adicionada. Especificar NULL expande o sujo região para cobrir toda a textura do volume.
Valor retornado
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 a caixa correspondente (dimensionada) também seja sujo. Regiões sujas são registradas automaticamente quando LockBox é chamado sem D3DLOCK_NO_DIRTY_UPDATE ou D3DLOCK_READONLY.
Usar D3DLOCK_NO_DIRTY_UPDATE e especificar explicitamente sujo regiões pode ser usado para aumentar a eficiência de UpdateTexture. Usando esse método, os aplicativos podem otimizar qual subconjunto de um recurso é copiado especificando sujo caixas no recurso. No entanto, as regiões de sujo podem ser expandidas para otimizar o alinhamento.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | d3d9helper.h (inclua D3D9.h) |
| Biblioteca | D3D9.lib |