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

Статья
08/07/2023

Подпрограмма StorPortLogTelemetry регистрирует событие телеметрии минипорта для диагностики или сбора полезных сведений.

Синтаксис

ULONG StorPortLogTelemetryEx(
  PVOID                     HwDeviceExtension,
  PSTOR_ADDRESS             StorAddress,
  PSTORPORT_TELEMETRY_EVENT Event,
  STOR_TELEMETRY_CATEGORY   Category
);

Параметры

HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

StorAddress

Адрес устройства единицы хранения. Этот параметр имеет значение NULL для устройств адаптера.

Event

Указатель на структуру STORPORT_TELEMETRY_EVENT , содержащую полезные данные телеметрии.

Category

STOR_TELEMETRY_CATEGORY значение перечисления, указывающее категорию данных телеметрии для ведения журнала.

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

StorPortLogTelemetryEx возвращает один из следующих кодов состояния:

Код возврата	Описание
STOR_STATUS_INVALID_BUFFER_SIZE	Событие->Размер EventBufferLength превышает EVENT_BUFFER_MAX_LENGTH.
STOR_STATUS_INVALID_PARAMETER	Указатель на один из параметров имеет значение NULL или Для EventBufferLength задано значение 0 для event-EventBuffer>, отличного от NULL.
STOR_STATUS_NOT_IMPLEMENTED	Эта функция не реализована в активной операционной системе.
STOR_STATUS_SUCCESS	Событие телеметрии успешно зарегистрировано.

Мини-порт может вызывать StorPortLogTelemetryEx , чтобы регистрировать меры трассировки или событие телеметрии с данными, настроенными для минипорта. Минипорты указывают тип категории событий в поле Категория.

Данные события инкапсулируются в структуру STORPORT_TELEMETRY_EVENT , на которую указывает событие . Мини-порт может записывать в журнал восемь пар "имя-значение" общего назначения и буфер с максимальной длиной 4 КБ, а также несколько полей, связанных с событиями.