Функция DdGetDC (ddrawgdi.h)
[Эта функция может изменяться с каждой редакцией операционной системы. Вместо этого используйте DirectDraw и Microsoft Direct3DAPis; эти API изолируют приложения от таких изменений операционной системы и скрывают многие другие трудности, связанные с взаимодействием непосредственно с драйверами дисплея.]
Оболочка для функции NtGdiDdGetDC и возвращает контекст устройства интерфейса графических устройств Windows (GDI), который представляет указанную поверхность Microsoft DirectDraw.
GdiEntry7 определяется как псевдоним для этой функции.
Синтаксис
HDC DdGetDC(
LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
LPPALETTEENTRY pColorTable
);
Параметры
pSurfaceLocal
Указатель на поверхность DirectDraw, для которой запрашивается контроллер домена.
pColorTable
Необязательный указатель на 256-входной массив структур PALETTEENTRY . Если таблица цветов имеет значение NULL, а режим поверхности и режима отображения составляет 8 бит на пиксель, контроллер домена использует таблицу цветов устройства.
Возвращаемое значение
В случае успешного выполнения эта функция возвращает допустимое значение HDC; В противном случае возвращается значение NULL.
Комментарии
Если и поверхность, и текущий режим отображения поддонизированы со скоростью 8 бит на пиксель, контроллеру домена может быть присвоено специальное свойство, согласно которому таблица цветов совместно используется таблицей цветов устройства отображения. Приложениям рекомендуется вместо этого вызывать IDirectDrawSurface7::GetDC , который обеспечивает те же функциональные возможности независимо от операционной системы.
Возвращенный контроллер домена должен быть освобожден вызовом NtGdiDdReleaseDC или GdiEntry8.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | ddrawgdi.h |