IDirectDraw7::CreateSurface-Methode (ddraw.h)
Erstellt ein DirectDrawSurface-Objekt für dieses DirectDraw-Objekt.
Syntax
HRESULT CreateSurface(
[in] LPDDSURFACEDESC2 unnamedParam1,
[out] LPDIRECTDRAWSURFACE7 *unnamedParam2,
[in] IUnknown *unnamedParam3
);
Parameter
[in] unnamedParam1
Adresse einer DDSURFACEDESC2 Struktur, die die angeforderte Oberfläche beschreibt. Legen Sie alle nicht verwendeten Member der DDSURFACEDESC2-Struktur auf 0 fest, bevor Sie diese Methode aufrufen. Eine DDSCAPS2-Struktur ist ein Element von DDSURFACEDESC2.
[out] unnamedParam2
Adresse einer Variablen, die auf einen gültigen IDirectDrawSurface7-Schnittstellenzeiger festgelegt werden soll, wenn der Aufruf erfolgreich ist.
[in] unnamedParam3
Ermöglicht zukünftige Kompatibilität mit COM-Aggregationsfeatures. Derzeit gibt diese Methode einen Fehler zurück, wenn dieser Parameter nicht NULL ist.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.
Wenn ein Fehler auftritt, kann die Methode einen der folgenden Fehlerwerte zurückgeben:
- 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
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |