Método IDirectDraw7::CreateSurface (ddraw.h)

Artigo
02/29/2024

Cria um objeto DirectDrawSurface para este objeto DirectDraw.

Sintaxe

HRESULT CreateSurface(
  [in]  LPDDSURFACEDESC2     unnamedParam1,
  [out] LPDIRECTDRAWSURFACE7 *unnamedParam2,
  [in]  IUnknown             *unnamedParam3
);

Parâmetros

[in] unnamedParam1

Endereço de uma estrutura DDSURFACEDESC2 que descreve a superfície solicitada. Defina todos os membros não utilizados da estrutura DDSURFACEDESC2 como 0 antes de chamar esse método. Uma estrutura DDSCAPS2 é membro de DDSURFACEDESC2.

[out] unnamedParam2

Endereço de uma variável a ser definida como um ponteiro de interface IDirectDrawSurface7 válido se a chamada for bem-sucedida.

[in] unnamedParam3

Permite a compatibilidade futura com recursos de agregação COM. Atualmente, esse método retornará um erro se esse parâmetro não for NULL.

Retornar valor

Se o método for bem-sucedido, o valor retornado será DD_OK.

Se falhar, o método poderá retornar um dos seguintes valores de erro:

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

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	ddraw.h
Biblioteca	Ddraw.lib
DLL	Ddraw.dll

Confira também

IDirectDraw7

Compartilhar via