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