Méthode IDirect3DDevice9::UpdateSurface (d3d9helper.h)

Article
08/23/2023

Copie des sous-ensembles rectangulaires de pixels d’une surface à une autre.

Syntaxe

HRESULT UpdateSurface(
  [in] IDirect3DSurface9 *pSourceSurface,
  [in] const RECT        *pSourceRect,
  [in] IDirect3DSurface9 *pDestinationSurface,
  [in] const POINT       *pDestPoint
);

Paramètres

[in] pSourceSurface

Type : IDirect3DSurface9*

Pointeur vers une interface IDirect3DSurface9 , représentant la surface source. Ce paramètre doit pointer vers une surface différente de pDestinationSurface.

[in] pSourceRect

Type : const RECT*

Pointeur vers un rectangle sur la surface source. La spécification NULL pour ce paramètre entraîne la copie de la surface entière.

[in] pDestinationSurface

Type : IDirect3DSurface9*

Pointeur vers une interface IDirect3DSurface9 , représentant la surface de destination.

[in] pDestPoint

Type : const POINT*

Pointeur vers le coin supérieur gauche du rectangle de destination. La spécification NULL pour ce paramètre entraîne la copie de la surface 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 l’une des suivantes : D3DERR_INVALIDCALL.

Notes

Cette méthode est similaire à CopyRects dans DirectX 8.

Cette fonction présente les restrictions suivantes.

La surface source doit avoir été créée avec D3DPOOL_SYSTEMMEM.
L’aire de destination doit avoir été créée avec D3DPOOL_DEFAULT.
Aucune surface ne peut être verrouillée ou contenir un contexte d’appareil en suspens.
Aucune surface ne peut être créée avec le multi-échantillonnage. Le seul indicateur valide pour les deux surfaces est D3DMULTISAMPLE_NONE.
Le format surface ne peut pas être un format de gabarit de profondeur.
Les rects source et dest doivent s’insérer dans la surface.
Aucun étirement ou réduction n’est autorisé (les rects doivent avoir la même taille).
Le format source doit correspondre au format dest.

Le tableau suivant montre les combinaisons prises en charge.

		Formats dest
		Texture	Texture RT	RT	Hors écran simple
Formats Src	Texture	Oui	Oui	Oui*	Oui
	Texture RT	Non	Non	Non	Non
	RT	Non	Non	Non	Non
	Hors écran simple	Oui	Oui	Oui	Oui

Si le pilote ne prend pas en charge la copie demandée, elle sera émulée à l’aide du verrouillage et de la copie.

Si l’application doit copier des données d’une cible de rendu D3DPOOL_DEFAULT vers une surface de D3DPOOL_SYSTEMMEM, elle peut utiliser GetRenderTargetData.

Spécifications


Plateforme cible	Windows
En-tête	d3d9helper.h (incluez D3D9.h)
Bibliothèque	D3D9.lib

Voir aussi

IDirect3DDevice9

Partager via