Metodo IDirectDrawSurface7::D eleteAttachedSurface (ddraw.h)

Scollega una o più superfici associate.

Sintassi

HRESULT DeleteAttachedSurface(
  [in] DWORD                unnamedParam1,
  [in] LPDIRECTDRAWSURFACE7 unnamedParam2
);

Parametri

[in] unnamedParam1

Attualmente non usato e deve essere impostato su 0.

[in] unnamedParam2

Puntatore all'interfaccia IDirectDrawSurface7 per l'oggetto DirectDrawSurface da scollegare. Se questo parametro è NULL, tutte le superfici associate diventano scollegate.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è DD_OK.

Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:

• DDERR_CANNOTDETACHSURFACE
• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_SURFACELOST
• DDERR_SURFACENOTATTACHED

Commenti

DeleteAttachedSurface decrementa il conteggio dei riferimenti della superficie da scollegare. Se il numero di riferimenti della superficie da scollegare raggiunge 0, la superficie viene persa e rimossa dalla memoria.

Gli allegati impliciti, formati da DirectDraw anziché dal metodo IDirectDrawSurface7::AddAttachedSurface , non possono essere scollegati. La rimozione delle superfici da una catena di scorrimento può modificare altre superfici nella catena. Se un buffer anteriore viene scollegato da una catena di scorrimento, la superficie successiva nella catena diventa il buffer anteriore e la superficie seguente diventa il buffer posteriore. Se un buffer indietro viene scollegato da una catena, la superficie seguente diventa un buffer indietro. Se una superficie normale viene scollegata da una catena, la catena diventa semplicemente più breve. Se una catena di capovolgimento ha solo due superfici e vengono scollegate, la catena viene distrutta e entrambe le superfici tornano alle loro designazioni precedenti.

Requisiti

Vedi anche

IDirectDrawSurface7