IDirectDrawSurface7::D eleteAttachedSurface-Methode (ddraw.h)

Trennt eine oder mehrere angefügte Flächen.

Syntax

HRESULT DeleteAttachedSurface(
  [in] DWORD                unnamedParam1,
  [in] LPDIRECTDRAWSURFACE7 unnamedParam2
);

Parameter

[in] unnamedParam1

Derzeit nicht verwendet und muss auf 0 festgelegt werden.

[in] unnamedParam2

Ein Zeiger auf die IDirectDrawSurface7-Schnittstelle für das zu lösende DirectDrawSurface-Objekt. Wenn dieser Parameter NULL ist, werden alle angefügten Flächen getrennt.

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_CANNOTDETACHSURFACE
• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_SURFACELOST
• DDERR_SURFACENOTATTACHED

Hinweise

DeleteAttachedSurface verringert die Verweisanzahl der zu trennenden Fläche. Wenn die Referenzanzahl der zu trennenden Fläche 0 erreicht, geht die Oberfläche verloren und wird aus dem Arbeitsspeicher entfernt.

Implizite Anlagen, die von DirectDraw anstelle der IDirectDrawSurface7::AddAttachedSurface-Methode gebildet werden, können nicht getrennt werden. Das Trennen von Oberflächen von einer umklappenden Kette kann andere Oberflächen in der Kette ändern. Wenn ein vorderer Puffer von einer umklappenden Kette getrennt wird, wird die nächste Oberfläche in der Kette zum vorderen Puffer, und die folgende Oberfläche wird zum Hintergrundpuffer. Wenn ein Hintergrundpuffer von einer Kette getrennt wird, wird die folgende Oberfläche zu einem Hintergrundpuffer. Wenn eine einfache Oberfläche von einer Kette getrennt wird, wird die Kette einfach kürzer. Wenn eine umklappende Kette nur zwei Oberflächen aufweist und sie getrennt werden, wird die Kette zerstört, und beide Oberflächen kehren zu ihren vorherigen Bezeichnungen zurück.

Anforderungen

Weitere Informationen

IDirectDrawSurface7