Partager via

Méthode IDirect3DVolumeTexture9 ::AddDirtyBox (d3d9.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.

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

Voir aussi

IDirect3DVolumeTexture9