функция обратного вызова DXGKDDI_CREATECONTEXT (d3dkmddi.h)

  • Статья

Функция DxgkDdiCreateContext создает контекст графического процессора (GPU).

Синтаксис

DXGKDDI_CREATECONTEXT DxgkddiCreatecontext;

NTSTATUS DxgkddiCreatecontext(
  [in]     IN_CONST_HANDLE hDevice,
  [in/out] INOUT_PDXGKARG_CREATECONTEXT pCreateContext
)
{...}

Параметры

[in] hDevice

Дескриптор устройства контекста графики, на который создается новый контекст. Функция DxgkDdiCreateDevice драйвера дисплея miniport ранее предоставляла этот дескриптор подсистеме графического ядра Microsoft DirectX в элементе hDeviceструктуры DXGKARG_CREATEDEVICE .

[in/out] pCreateContext

Указатель на структуру DXGKARG_CREATECONTEXT , содержащую сведения о создании контекста.

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

DxgkDdiCreateContext возвращает одно из следующих значений:

Код возврата Описание
STATUS_SUCCESS DxgkDdiCreateContext успешно создал контекст.
STATUS_NO_MEMORY DxgkDdiCreateContext не удалось выделить память, необходимую для ее завершения.
STATUS_GRAPHICS_DRIVER_MISMATCH Драйвер мини-порта дисплея несовместим с драйвером дисплея пользовательского режима, который инициировал вызов DxgkDdiCreateContext.

Комментарии

Драйвер использует контекст GPU для хранения коллекции состояний отрисовки.

Один процесс может создать несколько контекстов на данном устройстве.

Драйвер должен поддерживать произвольное количество контекстов. Единственной веской причиной, по которой драйверу не удалось создать контекст, является нехватка системной памяти.

Как правило, каждый контекст может ссылаться на любой ресурс, ранее созданный для устройства, которому принадлежит этот контекст.

DxgkDdiCreateContext должен быть доступным для страниц.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Целевая платформа Персональный компьютер
Верхняя часть d3dkmddi.h
IRQL PASSIVE_LEVEL

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

DXGKARG_CREATECONTEXT

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice