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

Функция NtGdiDdDesurface

  • Статья

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

Уничтожает ранее выделенный объект поверхности Microsoft DirectDraw в режиме ядра.

Синтаксис

DWORD APIENTRY NtGdiDdDestroySurface(
  _In_ HANDLE hSurface,
  _In_ BOOL   bRealDestroy
);

Параметры

hSurface [in]

Дескриптор ранее выделенного объекта поверхности режима ядра.

bRealDeстрой [in]

Указывает способ уничтожения поверхности. Может иметь одно из следующих значений.

(TRUE)

Уничтожьте поверхность и свободную видеопамять.

(FALSE)

Освободите видеопамяти, но оставьте поверхность в неинициализированном состоянии.

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

NtGdiDdDe примеровsurface возвращает один из следующих кодов обратного вызова.

Код возврата Описание
DDHAL_DRIVER_HANDLED
 Драйвер выполнил операцию и вернул допустимый код возврата для этой операции. Если этот код DD_OK, DirectDraw или Direct3D продолжает работу с функцией . В противном случае DirectDraw или Direct3D возвращает код ошибки, предоставленный драйвером, и прерывает функцию.
DDHAL_DRIVER_NOTHANDLED
 Драйвер не имеет комментариев к запрошенной операции. Если драйвер должен реализовать определенный обратный вызов, DirectDraw или Direct3D сообщает об ошибке. В противном случае DirectDraw или Direct3D обрабатывает операцию так, как если бы обратный вызов драйвера не был определен путем выполнения аппаратной реализации DirectDraw или Direct3D.

 

Комментарии

Приложениям рекомендуется использовать API DirectDraw и Direct3D для создания и уничтожения поверхностей вместо этой функции.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Ntgdi.h

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

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