IDirectDrawSurface7::GetAttachedSurface-Methode (ddraw.h)

Ruft die angefügte Oberfläche ab, die über die angegebenen Funktionen verfügt, und erhöht die Verweisanzahl der abgerufenen Schnittstelle.

Syntax

HRESULT GetAttachedSurface(
  [in]  LPDDSCAPS2           unnamedParam1,
  [out] LPDIRECTDRAWSURFACE7 *unnamedParam2
);

Parameter

[in] unnamedParam1

Ein Zeiger auf eine DDSCAPS2 Struktur, die die Hardwarefunktionen der angeschlossenen Oberfläche angibt.

[out] unnamedParam2

Ein Zeiger auf eine Variable, um einen Zeiger auf die IDirectDrawSurface7-Schnittstelle der abgerufenen Oberfläche zu empfangen. Die abgerufene Oberfläche entspricht der Beschreibung gemäß dem lpDDSCaps-Parameter .

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_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_NOTFOUND
• DDERR_SURFACELOST

Hinweise

Anlagen werden verwendet, um mehrere DirectDrawSurface-Objekte mit komplexen Strukturen zu verbinden, z. B. die komplexen Strukturen, die zum Unterstützen des 3D-Seiten flippings mit z-Puffern erforderlich sind. GetAttachedSurface schlägt fehl, wenn mehr als eine Oberfläche angefügt ist, die den angeforderten Funktionen entspricht. In diesem Fall muss die Anwendung die IDirectDrawSurface7::EnumAttachedSurfaces-Methode verwenden, um die angefügten Oberflächen abzurufen.

Anforderungen

Weitere Informationen

IDirectDrawSurface7