Méthode IDirectDraw7 ::D uplicateSurface (ddraw.h)
Dupliquer un objet DirectDrawSurface.
Syntaxe
HRESULT DuplicateSurface(
[in] LPDIRECTDRAWSURFACE7 unnamedParam1,
[out] LPDIRECTDRAWSURFACE7 *unnamedParam2
);
Paramètres
[in] unnamedParam1
Adresse de l’interface IDirectDrawSurface7 pour la surface à dupliquer.
[out] unnamedParam2
Adresse d’une variable pour contenir un pointeur d’interface IDirectDrawSurface7 pour l’objet DirectDrawSurface nouvellement dupliqué.
Valeur retournée
Si la méthode réussit, la valeur de retour est DD_OK.
En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :
- DDERR_CANTDUPLICATE
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
- DDERR_SURFACELOST
Remarques
DuplicateSurface crée un objet DirectDrawSurface qui pointe vers la même mémoire surface qu’un objet DirectDrawSurface existant. Ce doublon peut être utilisé comme l’objet d’origine. La mémoire surface est libérée après la libération du dernier objet qui y fait référence. Une surface principale, une surface 3D ou une surface créée implicitement ne peuvent pas être dupliquées.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |