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

Функция NtGdiDdUnattachSurface

  • Статья

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

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

Синтаксис

VOID APIENTRY NtGdiDdUnattachSurface(
  _In_ HANDLE hSurface,
  _In_ HANDLE hSurfaceAttached
);

Параметры

hSurface [in]

Объект поверхности режима ядра, переданный в качестве параметра hSurfaceFrom в NtGdiDdAttachSurface.

hSurfaceAttached [in]

Объект поверхности режима ядра, переданный в качестве параметра hSurfaceTo в NtGdiDdAttachSurface.

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

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

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

 

Комментарии

Приложениям рекомендуется использовать API DirectDraw, который обрабатывает поверхностные вложения более высокого уровня.

Вызывать эту функцию необязательно, так как ядро автоматически уничтожает все вложения при вызове NtGdiDdDefaceSurface .

Требования

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

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

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