_DXGK_DEBUG_REPORT_INTERFACE structure

The DXGK_DEBUG_REPORT_INTERFACE structure contains pointers to functions in the Debug Report interface, which is implemented by the display port driver.

Syntax

typedef struct _DXGK_DEBUG_REPORT_INTERFACE {
  USHORT                    Size;
  USHORT                    Version;
  PVOID                     Context;
  PINTERFACE_REFERENCE      InterfaceReference;
  PINTERFACE_DEREFERENCE    InterfaceDereference;
  DXGK_DEBUG_REPORT_HANDLE( )(HANDLE DeviceHandle,ULONG ulCode,ULONG_PTR ulpArg1,ULONG_PTR ulpArg2,ULONG_PTR ulpArg3,ULONG_PTR ulpArg4) *DbgReportCreate;
  BOOLEAN( )(DXGK_DEBUG_REPORT_HANDLE hReport,PVOID pvData,ULONG ulDataSize)                  *DbgReportSecondaryData;
  VOID( )(DXGK_DEBUG_REPORT_HANDLE hReport)                     *DbgReportComplete;
} DXGK_DEBUG_REPORT_INTERFACE, *PDXGK_DEBUG_REPORT_INTERFACE;

Members

Size

The size, in bytes, of this structure.

Version

The version number of the Debug Report interface. Version number constants are defined in Dispmprt.h (for example, DXGK_DEBUG_REPORT_INTERFACE_VERSION_1).

Context

A pointer to a context that is provided by the display port driver.

InterfaceReference

A pointer to an interface reference function that is implemented by the display port driver.

InterfaceDereference

A pointer to an interface dereference function that is implemented by the display port driver.

DbgReportCreate

Creates an initial error report.

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.

DeviceHandle

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

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

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

ulpArg2

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

ulpArg3

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

ulpArg4

Reserved.

DbgReportSecondaryData

appends data to an initial error report that was previously created by DbgReportCreate.

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

Call DbgReportSecondaryData to add data to an initial report that was created by a previous call to DbgReportCreate. You can call DbgReportSecondaryData several times, but with each call, the data written to the report overwrites the data written by the previous call. The following steps give a good strategy for incrementally adding data to the report.

  1. Obtain the data that is safest to collect.
  2. Call DbgReportSecondaryData to write that data to the report.
  3. Obtain data that is more risky to collect.
  4. Call DbgReportSecondaryData to write the original safe data along with the newly collected risky data to the report. You must include both the safe and the risky data in this call because the data written by this call overwrites the data written by the first call to DbgReportSecondaryData.
  5. Continue calling DbgReportSecondaryData, enhancing the data each time, until you have no more data to add.
  6. When you have finished adding data to the report, close the report by calling DbgReportComplete. The report is stored in a file and sent to Microsoft when the computer is rebooted.
  7. If the computer stops responding before you call DbgReportComplete, the data added to the report by the most recent successful call to DbgReportSecondaryData is saved and then sent to Microsoft when the computer is rebooted.

hReport

A handle to the error report to which data will be appended. The display miniport driver previously obtained this handle by calling DbgReportCreate.

pvData

A pointer to a buffer that holds the data to be added to the report.

ulDataSize

The size, in bytes, of the data to be added to the report. The value of this parameter must be less than or equal to DXGK_DEBUG_REPORT_MAX_SIZE.

DbgReportComplete

Closes an error report and frees any resources associated with the report.

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

DbgReportCreate creates an entry in the system event log and displays a dialog box that informs the user of the failure and presents the opportunity to upload an error report to Microsoft.

The error report is saved in a file and scheduled to be sent to Microsoft when the computer is rebooted. The error report contains an error code and four arguments. The error code and the first three arguments are provided by the caller of DbgReportCreate. The fourth argument in the report is provided by the operating system and indicates the number of reports generated since the computer was started. For example, if the value of the fourth argument is 5, this means that four previous error reports were generated by the display miniport driver since the computer was last started. Only the fifth report is saved because each report overwrites the previous one.

hReport

A handle to the error report that is to be closed. The display miniport driver previously obtained this handle by calling DbgReportCreate.

Remarks

The display miniport driver supplies the Size and Version members of this structure, and then calls DxgkCbQueryServices, which fills in the remaining members of this structure.

Requirements

   
Windows version Available in Windows Vista and later versions of the Windows operating systems. Available in Windows Vista and later versions of the Windows operating systems.
Header dispmprt.h (include Dispmprt.h)