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