Méthode IDirectDraw7 ::CreateSurface (ddraw.h)
Crée un objet DirectDrawSurface pour cet objet DirectDraw.
Syntaxe
HRESULT CreateSurface(
[in] LPDDSURFACEDESC2 unnamedParam1,
[out] LPDIRECTDRAWSURFACE7 *unnamedParam2,
[in] IUnknown *unnamedParam3
);
Paramètres
[in] unnamedParam1
Adresse d’une structure DDSURFACEDESC2 qui décrit la surface demandée. Définissez tous les membres inutilisés de la structure DDSURFACEDESC2 sur 0 avant d’appeler cette méthode. Une structure de DDSCAPS2 est membre de DDSURFACEDESC2.
[out] unnamedParam2
Adresse d’une variable à définir sur un pointeur d’interface IDirectDrawSurface7 valide si l’appel réussit.
[in] unnamedParam3
Permet une compatibilité future avec les fonctionnalités d’agrégation COM. Actuellement, cette méthode retourne une erreur si ce paramètre n’a pas la valeur NULL.
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_INCOMPATIBLEPRIMARY
- DDERR_INVALIDCAPS
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDPIXELFORMAT
- DDERR_NOALPHAHW
- DDERR_NOCOOPERATIVELEVELSET
- DDERR_NODIRECTDRAWHW
- DDERR_NOEMULATION
- DDERR_NOEXCLUSIVEMODE
- DDERR_NOFLIPHW
- DDERR_NOMIPMAPHW
- DDERR_NOOVERLAYHW
- DDERR_NOZBUFFERHW
- DDERR_OUTOFMEMORY
- DDERR_OUTOFVIDEOMEMORY
- DDERR_PRIMARYSURFACEALREADYEXISTS
- DDERR_UNSUPPORTEDMODE
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |