Функция NtGdiD3DDrawPrimitives2

Статья
06/13/2023

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

Отрисовывает примитивы и возвращает обновленное состояние отрисовки.

Синтаксис

DWORD APIENTRY NtGdiD3DDrawPrimitives2(
  _In_    HANDLE                         hCmdBuf,
  _In_    HANDLE                         hVBuf,
  _Inout_ LPD3DNTHAL_DRAWPRIMITIVES2DATA pded,
  _Inout_ FLATPTR                        *pfpVidMemCmd,
  _Inout_ DWORD                          *pdwSizeCmd,
  _Inout_ FLATPTR                        *pfpVidMemVtx,
  _Inout_ DWORD                          *pdwSizeVtx
);

Параметры

hCmdBuf [in]: Дескриптор структуры DD_SURFACE_LOCAL , которая идентифицирует поверхность DirectDraw, содержащую командные данные.
hVBuf [in]: Дескриптор структуры DD_SURFACE_LOCAL , которая идентифицирует поверхность DirectDraw, содержащую данные вершин.
pded [in, out]: Указатель на структуру D3DNTHAL_DRAWPRIMITIVES2DATA , содержащую сведения, необходимые драйверу для отрисовки одного или нескольких примитивов.
pfpVidMemCmd [in, out]: Новый указатель на видеопамять, если драйвер переключил буфер команд.
pdwSizeCmd [in, out]: Указывает минимальное число байтов, на которое драйвер должен увеличить буфер команд подкачки.
pfpVidMemVtx [in, out]: Новый указатель на видеопамять, если драйвер переключил буфер вершин.
pdwSizeVtx [in, out]: Указывает минимальное количество байтов, которое драйвер должен выделить для буфера вершин подкачки.

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

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

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

Код возврата

Описание

DDHAL_DRIVER_HANDLED

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

DDHAL_DRIVER_NOTHANDLED

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

Требования

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

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

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

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