Функция 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

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

D3DKMT_SUBMITCOMMAND