IDirectDrawSurface7::AddAttachedSurface-Methode (ddraw.h)

Fügt die angegebene Z-Puffer-Oberfläche an diese Oberfläche an.

Syntax

HRESULT AddAttachedSurface(
  [in] LPDIRECTDRAWSURFACE7 unnamedParam1
);

Parameter

[in] unnamedParam1

Adresse der IDirectDrawSurface7-Schnittstelle für die anzufügende Oberfläche.

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_CANNOTATTACHSURFACE
• DDERR_GENERIC
• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_SURFACEALREADYATTACHED
• DDERR_SURFACELOST
• DDERR_WASSTILLDRAWING

Hinweise

AddAttachedSurface erhöht die Verweisanzahl der angefügten Oberfläche. Mithilfe der IDirectDrawSurface7::D eleteAttachedSurface-Methode können Sie das Anfügen der Oberfläche explizit aufheben und die Verweisanzahl verringern. Im Gegensatz zu komplexen Oberflächen, die Sie mit einem einzelnen Aufruf von IDirectDraw7::CreateSurface erstellen, werden mit dieser Methode angefügte Oberflächen nicht automatisch freigegeben. Die Anwendung muss solche Oberflächen freigeben.

Mit dieser Methode können Sie nur Z-Puffer-Oberflächen anfügen.

Anforderungen

Weitere Informationen

IDirectDrawSurface7