DXGKDDI_QUERYENGINESTATUS callback function (d3dkmddi.h)

The display port driver's GPU scheduler calls this function to determine the progress of a node within an active physical display adapter (engine).

Syntax

DXGKDDI_QUERYENGINESTATUS DxgkddiQueryenginestatus;

NTSTATUS DxgkddiQueryenginestatus(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_QUERYENGINESTATUS pQueryEngineStatus
)
{...}

Parameters

hAdapter

A handle to a context block that is associated with a display adapter. The display miniport driver previously provided this handle to the DirectX graphics kernel subsystem in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.

pQueryEngineStatus

A pointer to a DXGKARG_QUERYENGINESTATUS structure that specifies a node and physical adapter that are to be queried for progress, and that supplies a value for the progress.

Return value

Returns STATUS_SUCCESS if the function succeeds. Otherwise, this function returns one of the error codes defined in Ntstatus.h.

Remarks

This function should be made pageable, and it should always succeed.

The operating system guarantees that this function follows the first level synchronization mode as defined in Threading and Synchronization First Level.

For more information, see TDR changes in Windows 8.

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Desktop
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

See also

DXGKARG_QUERYENGINESTATUS

DxgkDdiAddDevice