Méthode IDirect3DTexture9 ::AddDirtyRect (d3d9.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
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | d3d9.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |