Storport 事件日志扩展

与许多其他类型的驱动程序一样，Storport 微型端口驱动程序必须在系统事件日志中创建条目，以使管理员了解附加存储设备的条件。 这些事件日志条目通常是为了响应与设备相关的故障而创建的。 还可以记录事件以用于遥测、调试和优化。

尽管 Windows 内核本身提供了用于创建事件日志条目的灵活接口，但 Storport 微型端口模型不允许微型端口驱动程序直接访问该接口。 相反，Storport 提供了内核系统事件日志设施的封装器，微型端口驱动程序利用该封装器来创建事件日志条目。

具体而言，Storport 提供以下事件日志例程：

• StorPortLogTelemetryEx 允许微型端口使用微型端口自定义数据（Windows 10 版本 1903 及更高版本）记录跟踪日志记录度量值或遥测事件。
• StorPortEtwChannelEvent2、StorPortEtwChannelEvent4，StorPortEtwChannelEvent8 允许微型端口将 ETW 事件发布到存储跟踪通道（Windows 10 版本 1809 及更新）。
• StorPortLogSystemEvent 允许微型端口创建事件日志条目（Windows 7 及更新）。

Storport 以"Microsoft-Windows-Storage-Storport"提供程序名称记录事件。 错误记录在 操作 通道中，调试/分析记录在 诊断（Analytic 和 调试）。 使用 事件查看器 应用程序时，必须先启用 诊断 通道才能查看它（若要启用，请选择 视图->显示分析和调试日志）。

上述函数作为 Storport 扩展函数实现，可用于使用现有扩展函数接口的微型端口驱动程序。 使用扩展函数接口可避免对新函数的直接动态链接引用。 通过避免直接引用，使用新函数的微型端口驱动程序可以在不支持该函数的操作系统上正确加载；当不支持该函数时，该函数将返回 STOR_STATUS_NOT_IMPLEMENTED。 通过这种方式，供应商可以创建在多个 OS 版本上运行的单个微型端口驱动程序，并利用支持的新事件日志记录函数。

在 Windows 7 之前的 Storport 版本中，Storport 的系统事件日志接口 StorPortLogError，允许微型端口驱动程序访问内核系统事件日志设施的功能的一小部分，这会影响微型端口事件日志条目的有用性。

有关 Windows 事件的一般信息，请参阅 Windows 事件。