Функция D3DKMTSubmitCommand (d3dkmthk.h)
D3DKMTSubmitCommand используется для отправки буферов команд в контекстах, поддерживающих виртуальную адресацию графического модуля обработки (GPU). Эти контексты создают команды непосредственно из пользовательского режима, управляют собственным пулом буферов команд и не используют список расположений выделения или исправлений.
Синтаксис
NTSTATUS D3DKMTSubmitCommand(
[in] const D3DKMT_SUBMITCOMMAND *unnamedParam1
);
Параметры
[in] unnamedParam1
Указатель на структуру D3DKMT_SUBMITCOMMAND, описывающую операцию.
Возвращаемое значение
| Возвращаемый код | Описание |
|---|---|
| STATUS_SUCCESS | Контекст устройства успешно создан. |
| STATUS_INVALID_PARAMETER | Параметры были проверены и определены как неверные. |
Эта функция также может возвращать другие значения NTSTATUS.
Замечания
Эта функция заменяет старую функцию render для таких контекстов и должна использоваться в своем месте. Контексты, работающие в устаревшем режиме исправлений, должны продолжать использовать старую функцию отрисовки.
Хотя драйвер пользовательского режима не создает расположения исправлений, он должен по-прежнему создавать список первичных элементов, в которые записываются. Диспетчер памяти видео использует список выделения, чтобы определить, на какие первичные выделения ссылаются для записи каждого буфера команд. Эти сведения используются для синхронизации отрисовки с основными операциями переверки.
Некоторые драйверы режима ядра нуждаются в информации из драйвера пользовательского режима по отправке определенного буфера прямого доступа к памяти (DMA) на gpu. В модели драйвера windows Display Driver Model (WDDM) 1.0 эта информация была отправлена драйвером пользовательского режима в драйвер режима ядра через буфер команд. Так как буфер DMA создается непосредственно драйвером пользовательского режима и отправляется в GPU без изменений, они больше не могут использоваться для отправки информации драйверу ядра. Чтобы включить передачу данных между драйверами пользовательского режима и режима ядра, добавлен явный буфер данных частного драйвера вместе с отправкой.
Заметка
Эти данные частного драйвера являются однонаправленными, и драйвер режима ядра не может возвращать сведения в драйвер пользовательского режима через этот буфер.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 10 |
| минимальный поддерживаемый сервер | Windows Server 2016 |
| целевая платформа | Всеобщий |
| заголовка | d3dkmthk.h (include D3dkmthk.h) |
| библиотеки | Gdi32.lib |
| DLL | Gdi32.dll |