HwVidBugcheckCallback routine

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



VOID HwVidBugcheckCallback(
  _In_ PVOID  HwDeviceExtension,
  _In_ ULONG  BugcheckCode,
  _In_ PUCHAR Buffer,
  _In_ ULONG  BufferSize
{ ... }


HwDeviceExtension [in]

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

BugcheckCode [in]

Specifies a bug check code.

Buffer [in]

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

BufferSize [in]

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

Return value



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.


Target platform



Video.h (include Video.h)

See also




Send comments about this topic to Microsoft

© 2015 Microsoft