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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |