DbgReportCreate callback function

The DbgReportCreate function creates an initial error report.

Syntax


DXGK_DEBUG_REPORT_HANDLE (*DbgReportCreate)(
  _In_  HANDLE DeviceHandle,
  _In_  ULONG ulCode,
  _In_  ULONG_PTR ulpArg1,
  _In_  ULONG_PTR ulpArg2,
  _In_  ULONG_PTR ulpArg3,
  _In_  ULONG_PTR ulpArg4
);

Parameters

DeviceHandle [in]

A handle to a context block associated with a display adapter. The display miniport driver created this handle in its DxgkDdiAddDevice function. This parameter can be NULL.

ulCode [in]

A code for the error report. The following codes are supported:

  • THREAD_STUCK_IN_DEVICE_DRIVER

  • VIDEO_DRIVER_DEBUG_REPORT_REQUEST

  • VIDEO_TDR_FATAL_ERROR

  • VIDEO_TDR_SUCCESS

ulpArg1 [in]

The first argument to be added to the report. The developer of the display miniport driver determines the value and meaning of ulpArg1.

ulpArg2 [in]

The second argument to be added to the report. The developer of the display miniport driver determines the value and meaning of ulpArg2.

ulpArg3 [in]

The third argument to be added to the report. The developer of the display miniport driver determines the value and meaning of ulpArg3.

ulpArg4 [in]

Reserved.

Return value

DbgReportCreate returns a handle to the newly created error report.

Remarks

This function is available in Windows Vista and later operating systems.

If your display miniport driver detects a failure and then recovers from it, you can create an error report that can later be used for debugging. First, call DbgReportCreateto create an initial report. Then add data to the report by making one or more calls to DbgReportSecondaryData. When you have finished adding data to the report, call DbgReportComplete.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Dispmprt.h (include Dispmprt.h)

IRQL

PASSIVE_LEVEL

See also

DbgReportComplete
DbgReportSecondaryData

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft