Функция DdCreateDirectDrawObject (ddrawgdi.h)
[Эта функция может изменяться с каждой редакцией операционной системы. Вместо этого используйте DirectDraw и Microsoft Direct3DAPIs; эти API изолируют приложения от таких изменений операционной системы и скрывают многие другие трудности, связанные с взаимодействием непосредственно с драйверами дисплея.]
Оболочка для функции NtGdiDdCreateDirectDrawObject и создает представление объекта Microsoft DirectDraw на стороне ядра. Дескриптор этого представления будет храниться в pDirectDrawGlobal-hDD>.
GdiEntry1 определяется как псевдоним для этой функции.
Синтаксис
BOOL DdCreateDirectDrawObject(
LPDDRAWI_DIRECTDRAW_GBL pDirectDrawGlobal,
HDC hdc
);
Параметры
pDirectDrawGlobal
Указатель на объект DirectDraw в пользовательском режиме. Дополнительные сведения см. в документации по DDK.
hdc
Дескриптор контроллера домена для устройства, для которого создано это представление. Если значение 0, устройство будет отображаться. Обратите внимание, что эта функция сохраняет только один объект DirectDraw "display" и возвращает скопированный дескриптор тому же объекту при последующем вызове с hdc = 0.
Возвращаемое значение
В случае успешного выполнения эта функция возвращает значение TRUE; В противном случае возвращается значение FALSE.
Комментарии
Приложениям рекомендуется использовать API DirectDraw и Direct3D для создания объектов графических устройств и управления ими. Эти конструкции абстрагируют процесс создания устройства упрощенным и независимым от операционной системы способом.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | ddrawgdi.h |