Méthode IDirect3DVolumeTexture9 ::AddDirtyBox (d3d9.h)
Ajoute une région sale à une ressource de texture de volume.
Syntaxe
HRESULT AddDirtyBox(
[in] const D3DBOX *pDirtyBox
);
Paramètres
[in] pDirtyBox
Type : const D3DBOX*
Pointeur vers une structure D3DBOX, spécifiant la région sale à ajouter. La spécification de null développe la région sale pour couvrir l’intégralité de la texture du volume.
Valeur retournée
Type : HRESULT
Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être D3DERR_INVALIDCALL.
Remarques
Pour des raisons de performances, sale régions sont enregistrées uniquement pour le niveau zéro d’une texture. Pour les sous-niveaux, il est supposé que la zone correspondante (mise à l’échelle) est également sale. Les régions sales sont automatiquement enregistrées lorsque LockBox est appelé sans D3DLOCK_NO_DIRTY_UPDATE ni D3DLOCK_READONLY.
En utilisant D3DLOCK_NO_DIRTY_UPDATE et en spécifiant explicitement sale régions, vous pouvez utiliser pour augmenter l’efficacité de UpdateTexture. À l’aide de cette méthode, les applications peuvent optimiser le sous-ensemble d’une ressource qui est copié en spécifiant sale zones sur la ressource. Toutefois, les régions sale peuvent être développées pour optimiser l’alignement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | d3d9.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |