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

Функция NtGdiDdGetDC

  • Статья

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

Создает контекст устройства (DC) для указанной поверхности.

Синтаксис

HDC APIENTRY NtGdiDdGetDC(
  _In_ HANDLE       hSurface,
  _In_ PALETTEENTRY *puColorTable
);

Параметры

hSurface [in]

Обработка поверхности DirectDraw в режиме ядра, ранее возвращенной ntGdiDdCreateSurface или NtGdiDdCreateSurfaceObject.

puColorTable [in]

Указатель на таблицу переопределения цветов для возвращаемого контроллера домена.

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

В случае успешного выполнения эта функция возвращает допустимый HDC; в противном случае возвращается ЗНАЧЕНИЕ NULL.

Комментарии

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

Вместо этого приложениям рекомендуется вызывать IDirectDrawSurface7::GetDC , который обеспечивает те же функции способом, не зависящим от операционной системы.

Требования

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

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

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

DdGetDC