Шаг 13 - Создание первичной поверхности - CreateSurface

Данная функция создает первичную и вторичную поверхность. Указатель на первичную поверхность, мы получим сразу, на вторичную позже.

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  

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 23.04.2002