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

Функция EngCreateDeviceSurface (winddi.h)

  • Статья

Функция EngCreateDeviceSurface создает и возвращает дескриптор для поверхности устройства, которым будет управлять драйвер.

Синтаксис

ENGAPI HSURF EngCreateDeviceSurface(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

Параметры

[in] dhsurf

Дескриптор устройства к поверхности, управляемой устройством. Этот дескриптор передается драйверу при передаче структуры SURFOBJ для входных или выходных данных.

[in] sizl

Задает структуру SIZEL, содержащую ширину и высоту создаваемой поверхности. Элементы cx и cy этой структуры содержат ширину и высоту поверхности соответственно в пикселях. Структура SIZEL идентична структуре SIZE .

iFormatCompat

Задает совместимый формат подсистемы создаваемой поверхности устройства. Это используется GDI, если для имитации сложного вызова рисования требуется временный буфер.

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

Возвращаемое значение — это дескриптор, который определяет поверхность, если функция выполнена успешно. В противном случае значение равно нулю и регистрируется код ошибки.

Комментарии

При необходимости драйвер может предоставить дисковое пространство для surface. Поверхность должна быть связана с помощью EngAssociateSurface. Поверхность должна быть удалена, если она больше не нужна с помощью EngDeleteSurface.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Универсальное
Верхняя часть winddi.h (включая Winddi.h)
Библиотека Win32k.lib
DLL Win32k.sys

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

EngAssociateSurface

EngDeleteSurface

SURFOBJ