Partager via

Méthode IDirect3DVolumeTexture9::AddDirtyBox (d3d9helper.h)

  • Article

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.

Notes

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.

Spécifications

   
Plateforme cible Windows
En-tête d3d9helper.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DVolumeTexture9