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


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

Функция EngLockDirectDrawSurface блокирует дескриптор в режиме ядра поверхности DirectDraw.

Синтаксис

ENGAPI PDD_SURFACE_LOCAL EngLockDirectDrawSurface(
  [in] HANDLE hSurface
);

Параметры

[in] hSurface

Дескриптор на запираемой поверхности.

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

EngLockDirectDrawSurface возвращает указатель на структуру DD_SURFACE_LOCAL , которая описывает сведения о поверхности при успешном выполнении. В противном случае возвращается указатель NULL .

Комментарии

EngLockDirectDrawSurface позволяет средствам записи драйверов блокировать поверхности DirectDraw. Блокировка дескриптора гарантирует синхронизированное поведение и сохраняет дескриптор от удаления другими потоками в системе.

В настоящее время драйвер получает дескрипторы поверхности DirectDraw только из интерфейса texturing Direct3D. Следовательно, только драйверы, выполняющие текстурирование, должны блокировать поверхности текстур.

После завершения разметки драйвер должен освободить заблокированный дескриптор, вызвав EngUnlockDirectDrawSurface.

Требования

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

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

DD_SURFACE_LOCAL

EngUnlockDirectDrawSurface