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

Weitere Informationen

IDirectDraw7