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 |