StorPortEtwLogError 函数 (storport.h)

项目
08/07/2023

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	Description 或 DataBuffer 为 NULL，或 DataBufferLength 不大于零。
STOR_STATUS_UNSUCCESSFUL	StorPort 由于其他原因（例如未启用 ETW 日志记录）而无法记录 ETW 事件。