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

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

  • Статья

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

Синтаксис

DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;

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

Параметры

hAdapter

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

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