Функция StorPortEtwLogError (storport.h)

Статья
02/07/2025

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

Идентификатор события, определяемый мини-портом, который однозначно идентифицирует событие.

[in] Description

Текст описания ошибки. Этот параметр является обязательным.

[in] DataBufferLength

Размер DataBufferв байтах.

[in] DataBuffer

Буфер размера переменной, содержащий двоичные данные, относящиеся к драйверу, которые полезны при выявлении причины ошибки. Драйверы должны указать размер этого буфера в параметре DataBufferLength.

Возвращаемое значение

Эта функция возвращает один из следующих кодов состояния.

Возвращаемый код	Описание
STOR_STATUS_SUCCESS	Событие успешно зарегистрировано.
STOR_STATUS_INVALID_PARAMETER	описание или DataBuffer равно NULL или DataBufferLength не превышает нуля.
STOR_STATUS_UNSUCCESSFUL	StorPort не удалось записать событие ETW по другим причинам, например ведение журнала ETW не включено.

Замечания

Минипорт может вызывать StorPortEtwLogError для регистрации события ETW для ошибки протокола оборудования. События, созданные из этой функции, публикуются в канале ETW Microsoft-Windows-Storage-Storport/Operational.