HwVidBugcheckCallback routine

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

Syntax


PVIDEO_BUGCHECK_CALLBACK HwVidBugcheckCallback;

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

Parameters

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

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

Header

Video.h (include Video.h)

See also

VideoPortRegisterBugcheckCallback

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft