Функция 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

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

[in] Description

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

[in] DataBufferLength

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

[in] DataBuffer

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

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

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

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

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