VideoPortRegisterBugcheckCallback 函数 (video.h)

  • 项目

VideoPortRegisterBugcheckCallback 函数允许视频微型端口驱动程序注册或挂钩在发生指定 bug 检查时调用的回调。

语法

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortRegisterBugcheckCallback(
  [in] IN PVOID                    HwDeviceExtension,
  [in] IN ULONG                    BugcheckCode,
  [in] IN PVIDEO_BUGCHECK_CALLBACK Callback,
  [in] IN ULONG                    BugcheckDataSize
);

参数

[in] HwDeviceExtension

指向微型端口驱动程序的设备扩展的指针。

[in] BugcheckCode

指示要回调的 bug 检查代码。 目前，微型端口驱动程序只能注册 bug 检查代码0xEA。

[in] Callback

指向微型端口驱动程序的 HwVidBugcheckCallback 函数的指针。 此函数必须是非分页的，并且不得引用可分页代码或数据。 微型端口驱动程序可以将此参数设置为 NULL，以指示应取消调用检查 bug。

[in] BugcheckDataSize

指示BUGCHECK_DATA_SIZE_RESERVED之和，以及微型端口驱动程序将提供的数据字节数，以便包含在转储文件中。 此参数的值必须小于或等于 4000。 微型端口驱动程序可以将此参数设置为零，以指示应取消调用检查 bug。

返回值

如果成功，VideoPortRegisterBugcheckCallback 将返回NO_ERROR。 否则，它将返回指示失败性质的状态代码。

注解

如果你正在开发一个视频微型端口驱动程序，打算在 Windows XP 或早期基于 NT 的操作系统上运行，则可以使用 VideoPortGetProcAddress 回调例程来查找 VideoPortRegisterBugcheckCallback 函数的地址。 有关详细信息，请参阅 使用 VideoPortGetProcAddress。

当发生特定类型的 bug 检查时，微型端口驱动程序可以注册回调。 目前，只能挂钩 bug 检查代码0xEA。 当出现 bug 检查时，将调用微型驱动程序提供的回调函数，微型端口驱动程序可以将数据追加到转储文件。 当无法直接调试时，这对于收集统计数据很有用。

BugcheckDataSize 参数的值必须比微型端口驱动程序提供的数据大BUGCHECK_DATA_SIZE_RESERVED字节。 例如，假设微型端口驱动程序提供要写入转储文件的数据DUMP_SIZE字节。 然后， BugcheckDataSize 的值应DUMP_SIZE + BUGCHECK_DATA_SIZE_RESERVED，并且总值必须小于或等于 4000。

video.h) 中定义的常量BUGCHECK_DATA_SIZE_RESERVED (在 Microsoft Windows Server 2003 及更高版本环境中可用。 在 Windows XP SP1 生成环境中，使用 48 而不是 BUGCHECK_DATA_SIZE_RESERVED。

微型端口驱动程序可以通过调用此函数、为 Callback 参数指定 NULL 或为 DataSize 参数指定零来取消注册以前注册的回调。

有关详细信息，请参阅 视频端口驱动程序对 Bug 检查回调的支持。

要求

要求 值
最低受支持的客户端 在 Windows XP SP1 及更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 video.h (包括 Video.h)
Library Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

另请参阅

HwVidBugcheckCallback