IDirectDraw7::D uplicateSurface-Methode (ddraw.h)
Dupliziert ein DirectDrawSurface-Objekt.
Syntax
HRESULT DuplicateSurface(
[in] LPDIRECTDRAWSURFACE7 unnamedParam1,
[out] LPDIRECTDRAWSURFACE7 *unnamedParam2
);
Parameter
[in] unnamedParam1
Adresse der IDirectDrawSurface7-Schnittstelle für die zu duplizierende Oberfläche.
[out] unnamedParam2
Adresse einer Variablen, die einen IDirectDrawSurface7-Schnittstellenzeiger für das neu duplizierte DirectDrawSurface-Objekt enthalten soll.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.
Wenn ein Fehler auftritt, kann die Methode einen der folgenden Fehlerwerte zurückgeben:
- DDERR_CANTDUPLICATE
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
- DDERR_SURFACELOST
Hinweise
DuplicateSurface erstellt ein neues DirectDrawSurface-Objekt, das auf denselben Oberflächenspeicher wie ein vorhandenes DirectDrawSurface-Objekt verweist. Dieses Duplikat kann genau wie das ursprüngliche Objekt verwendet werden. Der Oberflächenspeicher wird freigegeben, nachdem das letzte Objekt freigegeben wurde, das darauf verweist. Eine primäre Oberfläche, eine 3D-Oberfläche oder eine implizit erstellte Oberfläche kann nicht dupliziert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |