Méthode IDirectDrawSurface7 ::GetAttachedSurface (ddraw.h)
Obtient la surface attachée qui a les fonctionnalités spécifiées et incrémente le nombre de références de l’interface récupérée.
Syntaxe
HRESULT GetAttachedSurface(
[in] LPDDSCAPS2 unnamedParam1,
[out] LPDIRECTDRAWSURFACE7 *unnamedParam2
);
Paramètres
[in] unnamedParam1
Pointeur vers une structure de DDSCAPS2 qui indique les fonctionnalités matérielles de la surface attachée.
[out] unnamedParam2
Pointeur vers une variable pour recevoir un pointeur vers l’interface IDirectDrawSurface7 de la surface récupérée. La surface récupérée est celle qui correspond à la description, selon le paramètre lpDDSCaps .
Valeur retournée
Si la méthode réussit, la valeur de retour est DD_OK.
En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOTFOUND
- DDERR_SURFACELOST
Remarques
Les pièces jointes sont utilisées pour connecter plusieurs objets DirectDrawSurface à des structures complexes, telles que les structures complexes requises pour prendre en charge le basculement de page 3D avec z-buffers. GetAttachedSurface échoue si plusieurs surfaces sont attachées qui correspondent aux fonctionnalités demandées. Dans ce cas, l’application doit utiliser la méthode IDirectDrawSurface7 ::EnumAttachedSurfaces pour obtenir les surfaces attachées.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |