Metodo IDirectDrawSurface7::AddAttachedSurface (ddraw.h)
Collega la superficie del buffer z specificata a questa superficie.
Sintassi
HRESULT AddAttachedSurface(
[in] LPDIRECTDRAWSURFACE7 unnamedParam1
);
Parametri
[in] unnamedParam1
Indirizzo dell'interfaccia IDirectDrawSurface7 da collegare alla superficie.
Valore restituito
Se il metodo ha esito positivo, il valore restituito viene DD_OK.
Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:
- DDERR_CANNOTATTACHSURFACE
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_SURFACEALREADYATTACHED
- DDERR_SURFACELOST
- DDERR_WASSTILLDRAWING
Commenti
AddAttachedSurface incrementa il conteggio dei riferimenti della superficie associata. È possibile scollegare in modo esplicito la superficie e decrementare il conteggio dei riferimenti usando il metodo IDirectDrawSurface7::D eleteAttachedSurface . A differenza delle superfici complesse create con una singola chiamata a IDirectDraw7::CreateSurface, le superfici associate a questo metodo non vengono rilasciate automaticamente. L'applicazione deve rilasciare tali superfici.
È possibile collegare solo le superfici z-buffer con questo metodo.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |