функция обратного вызова 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
[in/out] Указатель на структуру 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 |