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
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |