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

Статья
08/23/2023

Создает объект 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

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