Méthode IDirect3DTexture9 ::AddDirtyRect (d3d9helper.h)

  • Article

Ajoute une région sale à une ressource de texture.

Syntaxe

HRESULT AddDirtyRect(
  [in] const RECT *pDirtyRect
);

Paramètres

[in] pDirtyRect

Type : const RECT*

Pointeur vers une structure RECT, spécifiant la région sale à ajouter. La spécification de null développe la région sale pour couvrir la texture entière.

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 le rectangle ou la zone correspondant (mis à l’échelle) est également sale. Les régions incorrectes sont automatiquement enregistrées lorsque IDirect3DTexture9 ::LockRect est appelé sans D3DLOCK_NO_DIRTY_UPDATE ni D3DLOCK_READONLY. La surface de destination de IDirect3DDevice9 ::UpdateSurface est également marquée sale automatiquement.

En utilisant D3DLOCK_NO_DIRTY_UPDATE et en spécifiant explicitement sale régions peuvent être utilisées pour augmenter l’efficacité de IDirect3DDevice9 ::UpdateTexture. À l’aide de cette méthode, les applications peuvent optimiser le sous-ensemble d’une ressource qui est copié en spécifiant sale régions 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 d3d9helper.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DTexture9