DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES callback function (d3dkmddi.h)

Set up or modify the scheduling properties for a device context.

Syntax

DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES DxgkddiSetcontextschedulingproperties;

NTSTATUS DxgkddiSetcontextschedulingproperties(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_SETCONTEXTSCHEDULINGPROPERTIES pSetContextSchedulingProperties
)
{...}

Parameters

hAdapter

A handle to the device context.

pSetContextSchedulingProperties

Pointer to a DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES structure that contains the scheduling properties.

Return value

Return STATUS_SUCCESS if the operation succeeds. Otherwise, return an appropriate NTSTATUS Values error code.

Remarks

Register your implementation of this callback function by setting the appropriate member of DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES and then calling DxgkDdiSetContextSchedulingProperties.

When an adapter is opened for the first time for a particular process, the OS calls DxgkDdiCreateProcess so that the kernel mode driver (KMD) can create an appropriate per process, per adapter tracking data structure. When a context is created, the KMD knows what device and adapter it is created for, and it should be able to look up the KMD process handle from the adapter tracking data structure for this process. Within the KMD process, the scheduler is expected to have tracking data structures for all four potential priority bands contexts should be assigned to.

When a context is created, or a Direct3D device changes priority, or an application gains or loses focus, the OS calls the GPU scheduler to set up or modify its scheduling properties. For newly created contexts, the OS guarantees that context scheduling properties will be set prior to the first submission to this context is allowed. This call can be made in the middle of a context execution. GPU scheduler has some leeway in terms of how it affects the current scheduling period, and the OS requirement is that the change should take effect on the next scheduling iteration for the priority band.

Requirements

Requirement	Value
Header	d3dkmddi.h