IDirectDraw7::CreateSurface-Methode (ddraw.h)

  • Artikel

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

Weitere Informationen

IDirectDraw7