DXGKDDI_SUBMITCOMMANDVIRTUAL callback function (d3dkmddi.h)

DxgkDdiSubmitCommandVirtual is used to submit a direct memory access (DMA) buffer to a context that supports virtual addressing.

The driver is responsible for making sure the correct address space is restored ahead of submitting a particular DMA buffer.

Syntax

DXGKDDI_SUBMITCOMMANDVIRTUAL DxgkddiSubmitcommandvirtual;

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

Parameters

hAdapter

A handle to a context block that is associated with a display adapter.

pSubmitCommand

A pointer to a DXGKARG_SUBMITCOMMANDVIRTUAL structure that describes operation.

Return value

Value	Description
STATUS_SUCCESS	The submitted command is well-formed.
STATUS_INVALID_PARAMETER	The DMA or private data is determined to be malformed. In this case, the OS will put the calling device in an error state and all subsequent calls on it will fail. The SubmissionFenceId value passed to this call will be considered completed after all previous packets on the hardware finished and at that point the driver notion of the last completed fence ID should be updated to this value. Note: This behavior is different from DxgkDdiSubmitCommand call where no error is allowed to be returned due to the ability to validate the data in a prior DxgkDdiRender call.

All other return values will lead to the OS bugcheck.

Requirements

Requirement	Value
Minimum supported client	Windows 10
Minimum supported server	Windows Server 2016
Target Platform	Desktop
Header	d3dkmddi.h

See also

DXGKARG_SUBMITCOMMANDVIRTUAL

DxgkDdiRender

DxgkDdiSubmitCommand