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

  • Статья

Функция DXGKDDI_CREATEDEVICE создает графическое контекстное устройство, которое впоследствии используется в вызовах функций драйвера мини-порта дисплея, относящихся к устройству.

Синтаксис

DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;

NTSTATUS DxgkddiCreatedevice(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}

Параметры

hAdapter

[in] Дескриптор для блока контекста, связанного с видеоадаптером. Драйвер мини-порта дисплея ранее предоставлял этот дескриптор dxgkrnl в выходном параметре MiniportDeviceContext функции DXGKDDI_ADD_DEVICE .

pCreateDevice

[вход/выход] Указатель на структуру DXGKARG_CREATEDEVICE , описывающую устройство контекста графики.

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

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

Код возврата Описание
STATUS_SUCCESS DXGKDDI_CREATEDEVICE успешно создано устройство контекста графики.
STATUS_NO_MEMORY DXGKDDI_CREATEDEVICE не удалось выделить память, необходимую для ее завершения.

Комментарии

Dxgkrnl вызывает функцию DXGKDDI_CREATEDEVICE драйвера минипорта дисплея, чтобы создать устройство контекста графики, которое графическая подсистема впоследствии передает вызовы драйверу минипорта дисплея. Драйвер использует устройство для хранения коллекции состояний отрисовки. Графическая подсистема может создать несколько устройств в одном процессе на адаптере графического процессора (GPU).

Примечание

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

Как правило, устройства не зависят друг от друга; Иными словами, ресурсы, созданные на одном устройстве, не могут ссылаться на ресурсы, созданные на другом устройстве, или получать к ним доступ. Однако межпроцессные ресурсы являются исключением из этого правила.

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

Требования

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

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

DXGKARG_CREATEDEVICE

DXGKDDI_ADD_DEVICE