Данная функция создает первичную и вторичную поверхность. Указатель на первичную поверхность, мы получим сразу, на вторичную позже.
Visual Basic Описание функции
Параметры Ошибки Описание функции
Параметры Возвращаемое значение
Visual C++
Visual Basic
object.CreateSurface( dd As DDSURFACEDESC2) As DirectDrawSurface7
object
Объектная переменная к объекту DirectDraw7.
dd
DDSURFACEDESC2 тип, который описывает запрошенную поверхность. Тип DDSCAPS2 - член DDSURFACEDESC2.
Если сбой метода, вызовется ошибка. Номер может быть установлен к одному из следующих значений:
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
Visual C++
HRESULT CreateSurface
(
LPDDSURFACEDESC2 lpDDSurfaceDesc,
LPDIRECTDRAWSURFACE7 FAR *lplpDDSurface,
IUnknown FAR *pUnkOuter
);
lpDDSurfaceDesc
Адрес структуры DDSURFACEDES, которая описывает запрошенную поверхность. Установите любые неиспользуемые элементы структуры DDSURFACEDESC к 0 перед вызовом этого метода. Структура DDSCAPS - член DDSURFACEDESC.
lplpDDSurface
Адрес переменной, которая будет установлена к допустимому IDIRECTDRAWSURFACE7 интерфейсу, если обращение преуспевает.
pUnkOuter
Учитывает будущую совместимость с 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