DXGKDDI_CREATECONTEXT callback function (d3dkmddi.h)

Article
02/22/2024

The DxgkDdiCreateContext function creates a graphics processing unit (GPU) context.

Syntax

DXGKDDI_CREATECONTEXT DxgkddiCreatecontext;

NTSTATUS DxgkddiCreatecontext(
  [in]     IN_CONST_HANDLE hDevice,
  [in/out] INOUT_PDXGKARG_CREATECONTEXT pCreateContext
)
{...}

Parameters

[in] hDevice

A handle to the graphics context device that the new context is created on. The display miniport driver's DxgkDdiCreateDevice function previously provided this handle to the Microsoft DirectX graphics kernel subsystem in the hDevice member of the DXGKARG_CREATEDEVICE structure.

[in/out] pCreateContext

A pointer to a DXGKARG_CREATECONTEXT structure that contains information about creating the context.

Return value

DxgkDdiCreateContext returns one of the following values:

Return code	Description
STATUS_SUCCESS	DxgkDdiCreateContext successfully created the context.
STATUS_NO_MEMORY	DxgkDdiCreateContext could not allocate memory that was required for it to complete.
STATUS_GRAPHICS_DRIVER_MISMATCH	The display miniport driver is not compatible with the user-mode display driver that initiated the call to DxgkDdiCreateContext.

Remarks

A driver uses a GPU context to hold a collection of rendering state.

A single process can create multiple contexts on a given device.

The driver must support an arbitrary number of contexts. The only valid reason why a driver could not create a context is if system memory runs out.

Typically, each context can reference any resource that was previously created for the device that owns that context.

DxgkDdiCreateContext should be made pageable.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Target Platform	Desktop
Header	d3dkmddi.h
IRQL	PASSIVE_LEVEL