DXGKDDI_COLLECTDIAGNOSTICINFO callback function

The DxgkDdiCollectDiagnosticInfo callback routine collects the private driver information for reasons that are specified by DXGK_DIAGNOSTICINFO_TYPE.

In Windows 10, version 1903, the driver will be called to collect private information if the function calls to DxgkDdiAddDevice or DxgkDdiStartDevice failed.

Syntax

DXGKDDI_COLLECTDIAGNOSTICINFO DxgkddiCollectdiagnosticinfo;

NTSTATUS DxgkddiCollectdiagnosticinfo(
  IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
  INOUT_PDXGKARG_COLLECTDIAGNOSTICINFO pCollectDiagnosticInfo
)
{...}

Parameters

PhysicalDeviceObject

[in] A pointer to a physical device object (PDO) that identifies a display adapter.

pCollectDiagnosticInfo

[in, out] A pointer to a DXGKARG_COLLECTDIAGNOSTICINFO structure which describes information collected by the driver.

Return Value

Return STATUS_SUCCESS if the private data information was successfully collected. Otherwise, returns STATUS_UNSUCCESSFUL if the driver couldn't collect the requested information.

Remarks

This function is called at PASSIVE level, at any time in between the calls to DxgkDdiAddDevice and DxgkDdiStartDevice, and should support synchronization zero level. The collected data shouldn't contain any private user information.

Requirements

   
Minimum supported client Windows 10, version 1903
Header dispmprt.h
IRQL PASSIVE_LEVEL