Функция StorPortLogTelemetry (storport.h)
Подпрограмма 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 возвращает один из следующих кодов состояния:
| Код возврата | Описание |
|---|---|
|
Размер EventBufferLength превышает EVENT_BUFFER_MAX_LENGTH. |
|
Указатель на один из параметров имеет значение NULL или EventBufferLength/EventBuffer в структуре события не совпадает. |
|
Эта функция не реализована в активной операционной системе. |
|
Данные о событиях телеметрии успешно зарегистрированы. |
Комментарии
Если какой-либо параметр в структуре события не имеет имени Event-ParameterNameX> == NULL, подпрограмма установит для соответствующего параметра значение 0.
Если у мини-порта нет полезных данных для заполнения Event-EventBuffer>, он должен установить Event-EventBufferLength> = 0, а также Event-EventBuffer> = NULL.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10 версии 1703 |
| Минимальная версия сервера | Windows Server 2016 |
| Целевая платформа | Windows |
| Header | storport.h (включая Storport.h) |
| IRQL | Любой |