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

Weitere Informationen

IDirectDraw7