Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The DxgkDdiSubmitCommandVirtual command submits a DMA buffer to a context that supports virtual addressing.
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. The display miniport driver (KMD) previously provided this handle to Dxgkrnl in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.
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. This behavior is different from a call toDxgkDdiSubmitCommand, 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 an OS bugcheck.
Remarks
DxgkDdiSubmitCommandVirtual works with virtual memory addressing, whereas DxgkDdiSubmitCommand is called with physical memory. DxgkDdiSubmitCommandVirtual allows the driver to manage memory more flexibly.
The GPU might have previously worked with a different address space, perhaps for another process or context. The driver is responsible for making sure the correct address space is restored ahead of submitting a particular DMA buffer.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 |
| Minimum supported server | Windows Server 2016 |
| Target Platform | Desktop |
| Header | d3dkmddi.h |