Storport 事件日志扩展

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

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

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

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

Storport 以“Microsoft-Windows-Storage-Storport”提供程序名称记录事件。 错误记录在操作通道中，调试/分析记录在诊断 (分析和调试) 中。 使用 事件查看器 应用程序时，必须先启用“诊断”通道以查看它 (启用，然后单击“查看>-显示分析和调试日志”) 。

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

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

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