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 (包括 Video.h) |
| Library | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | <= DIRQL |