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

Vedi anche

IDirectDrawSurface7