StorPortEtwLogError 函数 （storport.h）
StorPortEtwLogError 记录硬件协议错误的事件跟踪（ETW）事件。
语法
ULONG StorPortEtwLogError(
[in] PVOID HwDeviceExtension,
[in, optional] PSTOR_ADDRESS Address,
[in] ULONG Id,
[in] PWSTR Description,
[in] ULONG DataBufferLength,
[in] PVOID DataBuffer
);
参数
[in] HwDeviceExtension
指向微型端口设备扩展的指针。
[in, optional] Address
存储设备设备地址。 对于适配器设备，此参数为 NULL。
[in] Id
用于唯一标识事件的微型端口事件 ID。
[in] Description
错误的说明文本。 此参数是必需的。
[in] DataBufferLength
DataBuffer的大小（以字节为单位）。
[in] DataBuffer
一个可变大小的缓冲区，其中包含特定于驱动程序的二进制数据，可用于识别错误的原因。 驱动程序必须在 DataBufferLength 参数中指定此缓冲区的大小。
返回值
此函数返回以下状态代码之一。
| 返回代码 | 描述 |
|---|---|
| STOR_STATUS_SUCCESS | 已成功记录该事件。 |
| STOR_STATUS_INVALID_PARAMETER | 说明 或 DataBuffer 为 NULL，或 DataBufferLength 不大于零。 |
| STOR_STATUS_UNSUCCESSFUL | 由于其他原因（例如未启用 ETW 日志记录），StorPort 无法记录 ETW 事件。 |
言论
微型端口可以调用 StorPortEtwLogError 来记录硬件协议错误的 ETW 事件。 从此函数生成的事件将发布到“Microsoft-Windows-Storage-Storport/Operational”ETW 通道。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 10 版本 1903 |
| 标头 | storport.h |