PVIDEO_BUGCHECK_CALLBACK callback function (video.h)

The HwVidBugcheckCallback function enables the miniport driver to append data to a dump file when a bug check occurs.

Syntax

PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;

void PvideoBugcheckCallback(
  [in] IN PVOID HwDeviceExtension,
  [in] IN ULONG BugcheckCode,
  [in] IN PUCHAR Buffer,
  [in] IN ULONG BufferSize
)
{...}

Parameters

[in] HwDeviceExtension

Pointer to the miniport driver's per-adapter storage area. For more information, see Device Extensions.

[in] BugcheckCode

Specifies a bug check code.

[in] Buffer

Pointer to the memory location where the miniport driver can store the data that is to be appended to the dump file.

[in] BufferSize

Specifies the size, in bytes, of the buffer pointed to by the Buffer parameter.

Return value

None

Remarks

This function is available in Windows XP SP1 and later.

This function is called when a bug check occurs. The miniport driver can collect data that is to be appended to the dump file and write this data to the buffer. The driver must not write more than BufferSize bytes to the buffer.

A video miniport driver registers the HwVidBugcheckCallback function by calling the VideoPortRegisterBugcheckCallback function. The VideoPortRegisterBugcheckCallback function exposes this video miniport driver-supplied callback to the system.

To facilitate system recovery after a bug check, any registers that are accessed by this function must not impede the ability of the hardware to transfer to fallback mode, regardless of the state of the device. Also, the function must return control to its caller.

Because a system can consist of multiple video miniport drivers, venders should add an identifying string to the data that this function appends to the dump file.

The function is called at raised IRQL and must not attempt to access pageable code or data.

Requirements

Requirement Value
Target Platform Desktop
Header video.h (include Video.h)

See also

VideoPortRegisterBugcheckCallback