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

Статья
02/26/2024

Подпрограмма 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	Данные о событиях телеметрии успешно зарегистрированы.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 1703
Минимальная версия сервера	Windows Server 2016
Целевая платформа	Windows
Header	storport.h (включая Storport.h)
IRQL	Любой

См. также раздел

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx

Share via