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

Статья
02/07/2025

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

Синтаксис

ULONG StorPortLogTelemetry(
  [in]           PVOID                     HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS             StorAddress,
  [in]           PSTORPORT_TELEMETRY_EVENT Event
);

Параметры

[in] HwDeviceExtension

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

[in, optional] StorAddress

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

[in] Event

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

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

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

Возвращаемый код	Описание
STOR_STATUS_INVALID_BUFFER_SIZE	EventBufferLength больше EVENT_BUFFER_MAX_LENGTH.
STOR_STATUS_INVALID_PARAMETER	Указатель на один из параметров — NULL или EventBufferLength/EventBuffer в структуре событий не совпадает.
STOR_STATUS_NOT_IMPLEMENTED	Эта функция не реализована в активной операционной системе.
STATUS_SUCCESS	Данные событий телеметрии успешно зарегистрированы.

Замечания

Если какой-либо параметр в структуре событий не называется, event->ParameterNameX == NULL, подпрограмма присвоит соответствующему значению параметра значение 0.

Если мини-порт не имеет полезных данных для заполнения event->EventBuffer, он должен задать Event->EventBufferLength = 0, а также Event->EventBuffer = NULL.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1703
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
заголовка	storport.h (include Storport.h)
IRQL	Любой

См. также

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx

Поделиться через