video.h) (PVIDEO_BUGCHECK_CALLBACK 回调函数
HwVidBugcheckCallback 函数允许微型端口驱动程序在出现 bug 检查时将数据追加到转储文件。
语法
PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;
void PvideoBugcheckCallback(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG BugcheckCode,
[in] IN PUCHAR Buffer,
[in] IN ULONG BufferSize
)
{...}
参数
[in] HwDeviceExtension
指向微型端口驱动程序的每个适配器存储区域的指针。 有关详细信息，请参阅 设备扩展。
[in] BugcheckCode
指定 bug 检查代码。
[in] Buffer
指向内存位置的指针，微型端口驱动程序可在其中存储要追加到转储文件的数据。
[in] BufferSize
指定 Buffer 参数指向的缓冲区的大小（以字节为单位）。
返回值
无
备注
此函数在 Windows XP SP1 及更高版本中可用。
当出现 bug 检查时，将调用此函数。 微型端口驱动程序可以收集要追加到转储文件的数据，并将此数据写入缓冲区。 驱动程序不得将超过 BufferSize 字节写入缓冲区。
视频微型端口驱动程序通过调用 VideoPortRegisterBugcheckCallback 函数来注册 HwVidBugcheckCallback 函数。 VideoPortRegisterBugcheckCallback 函数向系统公开此视频微型端口驱动程序提供的回调。
为了在 bug 检查后促进系统恢复，无论设备的状态如何，此函数访问的任何寄存器都不得妨碍硬件传输到回退模式的能力。 此外，函数 必须将 控制权返回给其调用方。
由于系统可以包含多个视频微型端口驱动程序，因此供应商应向此函数追加到转储文件的数据中添加一个标识字符串。
函数在引发 IRQL 时调用，不得尝试访问可分页代码或数据。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | video.h (包括 Video.h) |