StorPortEtwLogError 函数 (storport.h)

StorPortEtwLogError 针对硬件协议Windows (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-存储-Storport/Operational"ETW 通道。

要求

   
最低受支持的客户端 Windows 10 版本 1903
标头 storport.h

请参阅

StorPortEtwEvent2

StorPortEtwEvent4

StorPortEtwEvent8

StorPortEtwLogByteStream