DXGKDDI_VALIDATESUBMITCOMMAND callback function

Validates private driver data, which is passed by user mode driver in D3DKMTSubmitCommand or D3DKMTSubmitCommandToHwQueue.

Syntax

DXGKDDI_VALIDATESUBMITCOMMAND DxgkddiValidatesubmitcommand;

NTSTATUS DxgkddiValidatesubmitcommand(
  IN_CONST_HANDLE hContext,
  INOUT_PDXGKARG_VALIDATESUBMITCOMMAND pArgs
)
{...}

Parameters

hContext

Driver context handle for the context.

pArgs

Pointer to a DXGKARG_VALIDATESUBMITCOMMAND structure.

Return Value

Returns NTSTATUS:

  • STATUS_SUCCESS
  • STATUS_INVALID_USER_BUFFER

Remarks

When this callback is implemented, private data, passed in DxgkDdiSubmitCommandVirtual or DxgkDdiSubmitCommandToHwQueue is always validated by kernel mode driver.

This callback is called only when private driver size in D3DKMTSubmitCommand is not zero. It is called once per D3DKMTSubmitCommand or D3DKMTSubmitCommandToHwQueue.

The kernel mode driver should not assume that this callback is called in the context of the process, which called D3DKMTSubmitCommand. So, the driver should not pass any user mode pointers or handles in private data.

This callback is called before the command is submitted to the GPU scheduler software queue.

Requirements

   
Minimum supported client Windows 10, version 1809
Header d3dkmddi.h
IRQL PASSIVE_LEVEL