IDirect3DCubeTexture9::AddDirtyRect, méthode (d3d9.h)

Article
08/23/2023

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

Syntaxe

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

Paramètres

[in] FaceType

Type : D3DCUBEMAP_FACES

Membre du D3DCUBEMAP_FACES type énuméré, identifiant la face de carte de cube.

[in] pDirtyRect

Type : const RECT*

Pointeur vers une structure RECT, spécifiant la région sale. La spécification null développe la région sale pour couvrir l’intégralité de la texture du cube.

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

L’utilisation de D3DLOCK_NO_DIRTY_UPDATE et la spécification explicite de 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.