функция обратного вызова DXGKDDI_SUBMITCOMMANDVIRTUAL (d3dkmddi.h)
DxgkDdiSubmitCommandVirtual используется для отправки буфера прямого доступа к памяти (DMA) в контекст, поддерживающий виртуальную адресацию.
Драйвер отвечает за восстановление правильного адресного пространства перед отправкой определенного буфера DMA.
Синтаксис
DXGKDDI_SUBMITCOMMANDVIRTUAL DxgkddiSubmitcommandvirtual;
NTSTATUS DxgkddiSubmitcommandvirtual(
IN_CONST_HANDLE hAdapter,
IN_CONST_PDXGKARG_SUBMITCOMMANDVIRTUAL pSubmitCommand
)
{...}
Параметры
hAdapter
Дескриптор к блоку контекста, связанному с адаптером отображения.
pSubmitCommand
Указатель на структуру DXGKARG_SUBMITCOMMANDVIRTUAL, описывающую операцию.
Возвращаемое значение
| значение | описание |
|---|---|
| STATUS_SUCCESS | Отправленная команда хорошо сформирована. |
| STATUS_INVALID_PARAMETER | DMA или частные данные определяются как неправильные. В этом случае ОС будет помещать вызывающее устройство в состояние ошибки, и все последующие вызовы к нему завершаются сбоем. Значение SubmissionFenceId, переданное этому вызову, будет считаться завершенным после завершения всех предыдущих пакетов на аппаратном оборудовании и в этом моменте необходимо обновить представление драйвера о последнем завершенном идентификаторе ограждения до этого значения. Примечание. это поведение отличается от вызова DxgkDdiSubmitCommand, где не разрешено возвращать ошибку из-за возможности проверки данных в предыдущем DxgkDdiRender. |
Все остальные возвращаемые значения приводят к проверки ошибки ОС.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 10 |
| минимальный поддерживаемый сервер | Windows Server 2016 |
| целевая платформа | Настольный |
| заголовка | d3dkmddi.h |