VideoPortLogError 函数 (video.h)

当微型端口驱动程序在 I/O作期间检测到硬件错误条件时,VideoPortLogError 函数将错误记录到系统事件日志中。

语法

VIDEOPORT_API VOID VideoPortLogError(
  PVOID                 HwDeviceExtension,
  PVIDEO_REQUEST_PACKET Vrp,
  VP_STATUS             ErrorCode,
  ULONG                 UniqueId
);

参数

HwDeviceExtension

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

Vrp

[可选]指向 [VIDEO_REQUEST_PACKET] 结构的指针,该结构描述视频请求数据包(VRP)(如果与错误相关联);否则为 NULL。

ErrorCode

指定指示硬件错误的类型的微型端口驱动程序定义的错误代码。

UniqueId

指定错误的唯一标识符。 此值将当前错误与其他错误区分开来,ErrorCode。 对于某些微型端口驱动程序,这标识检测到错误的代码行;对于其他人,它是硬件返回的值。

返回值

没有

言论

微型端口驱动程序应调用 VideoPortLogError,以在正常作期间驱动程序遇到异常的硬件错误时通知用户。 将此类错误发布到系统事件日志会警告用户视频适配器可能发生故障,以便用户在发生总硬件故障之前可以替换(或重新配置)适配器。

但是,微型端口驱动程序应 日志错误,例如“无法检测硬件”,在正常作期间经常发生。

可以从微型端口驱动程序的 HwVidInterruptHwVidSynchronizeExecutionCallback 函数调用 VideoPortLogError

要求

要求 价值
最低支持的客户端 Windows 2000
目标平台 桌面
标头 video.h (include Video.h)
Videoprt.lib
DLL Videoprt.sys
IRQL <= DIRQL

另请参阅

VideoDebugPrint