Поделиться через


Метод IDirectDraw7::CreateSurface (ddraw.h)

Создает объект DirectDrawSurface для этого объекта DirectDraw.

Синтаксис

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

Параметры

[in] unnamedParam1

Адрес структуры DDSURFACEDESC2 , описывающей запрошенную поверхность. Перед вызовом этого метода задайте для всех неиспользуемых элементов структуры DDSURFACEDESC2 значение 0. Структура DDSCAPS2 является членом DDSURFACEDESC2.

[out] unnamedParam2

Адрес переменной, для которую необходимо задать допустимый указатель интерфейса IDirectDrawSurface7 , если вызов выполнен успешно.

[in] unnamedParam3

Обеспечивает совместимость с функциями агрегирования COM в будущем. В настоящее время этот метод возвращает ошибку, если этот параметр не равен NULL.

Возвращаемое значение

Если метод выполнен успешно, возвращаемое значение будет DD_OK.

В случае сбоя метод может вернуть одно из следующих значений ошибки:

  • 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

Требования

Требование Значение
Целевая платформа Windows
Header ddraw.h
Библиотека Ddraw.lib
DLL Ddraw.dll

См. также раздел

IDirectDraw7