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


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

Команда DxgkDdiSubmitCommandVirtual отправляет буфер DMA в контекст, поддерживающий виртуальную адресацию.

Синтаксис

DXGKDDI_SUBMITCOMMANDVIRTUAL DxgkddiSubmitcommandvirtual;

NTSTATUS DxgkddiSubmitcommandvirtual(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_SUBMITCOMMANDVIRTUAL pSubmitCommand
)
{...}

Параметры

hAdapter

Дескриптор к блоку контекста, связанному с адаптером отображения. Ранее этот дескриптор отображался в dxgkrnl в выходном параметре MiniportDeviceContext функции DxgkDdiAddDevice .

pSubmitCommand

Указатель на структуру DXGKARG_SUBMITCOMMANDVIRTUAL , описывающую операцию.

Возвращаемое значение

значение описание
Статус: Успешно Отправленная команда хорошо сформирована.
STATUS_INVALID_PARAMETER (Статус: недопустимый параметр) DMA или частные данные определяются как неправильные. В этом случае ОС будет помещать вызывающее устройство в состояние ошибки, и все последующие вызовы к нему завершаются сбоем. Значение SubmissionFenceId, переданное этому вызову, будет считаться завершенным после завершения всех предыдущих пакетов на аппаратном оборудовании и в этом моменте необходимо обновить представление драйвера о последнем завершенном идентификаторе ограждения до этого значения. Это поведение отличается от вызоваDxgkDdiSubmitCommand, где ошибка не может быть возвращена из-за возможности проверки данных в предыдущем вызове DxgkDdiRender .

Все остальные возвращаемые значения приводят к ошибке ОС.

Замечания

DxgkDdiSubmitCommandVirtual работает с адресациями виртуальной памяти, а dxgkDdiSubmitCommand вызывается с физической памятью. DxgkDdiSubmitCommandVirtual позволяет драйверу более гибко управлять памятью.

Gpu, возможно, ранее работал с другим адресным пространством, возможно, для другого процесса или контекста. Драйвер отвечает за восстановление правильного адресного пространства перед отправкой определенного буфера DMA.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 10
минимальный поддерживаемый сервер Windows Server 2016
целевая платформа Настольный
заголовка d3dkmddi.h

См. также

DXGKARG_SUBMITCOMMANDVIRTUAL

DxgkDdiRender

DxgkDdiSubmitCommand