Metodo IDirect3DVolumeTexture9::AddDirtyBox (d3d9helper.h)
Aggiunge un'area dirty a una risorsa trama del volume.
Sintassi
HRESULT AddDirtyBox(
[in] const D3DBOX *pDirtyBox
);
Parametri
[in] pDirtyBox
Tipo: const D3DBOX*
Puntatore a una struttura D3DBOX , specificando l'area dirty da aggiungere. Se si specifica NULL , l'area dirty viene espansa per coprire l'intera trama del volume.
Valore restituito
Tipo: HRESULT
Se il metodo ha esito positivo, il valore restituito viene D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere D3DERR_INVALIDCALL.
Commenti
Per motivi di prestazioni, le aree dirty vengono registrate solo per il livello zero di una trama. Per i sublevel, si presuppone che anche la casella corrispondente (ridimensionata) sia dirty. Le aree dirty vengono registrate automaticamente quando LockBox viene chiamato senza D3DLOCK_NO_DIRTY_UPDATE o D3DLOCK_READONLY.
È possibile usare D3DLOCK_NO_DIRTY_UPDATE e specificare in modo esplicito le aree dirty per aumentare l'efficienza di UpdateTexture. Usando questo metodo, le applicazioni possono ottimizzare il subset di una risorsa copiata specificando caselle dirty nella risorsa. Tuttavia, le aree dirty possono essere espanse per ottimizzare l'allineamento.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | d3d9helper.h (include D3D9.h) |
| Libreria | D3D9.lib |