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


Функция DdCreateSurfaceObject (ddrawgdi.h)

[Эта функция может изменяться с каждой редакцией операционной системы. Вместо этого используйте Microsoft DirectDraw и Microsoft Direct3DAPIs; эти API изолируют приложения от таких изменений операционной системы и скрывают многие другие трудности, связанные с взаимодействием непосредственно с драйверами дисплея.]

Оболочка для функции NtGdiDdCreateSurfaceObject и создает объект поверхности в режиме ядра.

GdiEntry4 определяется как псевдоним для этой функции.

Синтаксис

BOOL DdCreateSurfaceObject(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
  BOOL                      bPrimarySurface
);

Параметры

pSurfaceLocal

Указатель на объект surface в пользовательском режиме. Дополнительные сведения см. в документации по DDK. Дескриптор объекта режима ядра помещается в pSurfaceLocal-hDDSurface>.

bPrimarySurface

Зарезервировано.

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

В случае успешного выполнения эта функция возвращает значение TRUE; В противном случае возвращается значение FALSE.

Комментарии

Эта функция используется для создания объектов, представляющих поверхности системной памяти. Поверхностям видеопамяти предоставляется представление в режиме ядра как неявная часть вызова NtGdiDdCreateSurfaceObject .

Приложениям рекомендуется использовать API DirectDraw и Direct3D для создания объектов графических устройств и управления ими. Эти конструкции абстрагируют процесс создания устройства упрощенным и независимым от операционной системы способом.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ddrawgdi.h

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

Поддержка клиентов нижнего уровня графики