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

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

Voir aussi

IDirect3DTexture9