Metodo IDirectDrawSurface7::GetAttachedSurface (ddraw.h)

Ottiene la superficie associata con le funzionalità specificate e incrementa il conteggio dei riferimenti dell'interfaccia recuperata.

Sintassi

HRESULT GetAttachedSurface(
  [in]  LPDDSCAPS2           unnamedParam1,
  [out] LPDIRECTDRAWSURFACE7 *unnamedParam2
);

Parametri

[in] unnamedParam1

Puntatore a una struttura DDSCAPS2 che indica le funzionalità hardware della superficie associata.

[out] unnamedParam2

Puntatore a una variabile per ricevere un puntatore all'interfaccia IDirectDrawSurface7 della superficie recuperata. La superficie recuperata corrisponde a quella corrispondente alla descrizione, in base al parametro lpDDSCaps .

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_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_NOTFOUND
• DDERR_SURFACELOST

Commenti

Gli allegati vengono usati per connettere più oggetti DirectDrawSurface in strutture complesse, ad esempio le strutture complesse necessarie per supportare lo scorrimento di pagine 3D con z-buffer. GetAttachedSurface ha esito negativo se più di una superficie è collegata che corrisponde alle funzionalità richieste. In questo caso, l'applicazione deve utilizzare il metodo IDirectDrawSurface7::EnumAttachedSurfaces per ottenere le superfici associate.

Requisiti

Vedi anche

IDirectDrawSurface7