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,以在正常作期间驱动程序遇到异常的硬件错误时通知用户。 将此类错误发布到系统事件日志会警告用户视频适配器可能发生故障,以便用户在发生总硬件故障之前可以替换(或重新配置)适配器。
但是,微型端口驱动程序应 不 日志错误,例如“无法检测硬件”,在正常作期间经常发生。
可以从微型端口驱动程序的 HwVidInterrupt 或 HwVidSynchronizeExecutionCallback 函数调用 VideoPortLogError。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 |
目标平台 | 桌面 |
标头 | video.h (include Video.h) |
库 | Videoprt.lib |
DLL | Videoprt.sys |
IRQL | <= DIRQL |