Функция StorPortLogTelemetryEx (storport.h)
Подпрограмма 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 КБ, а также несколько полей, связанных с событиями.
Требования
| Требование | Значение |
|---|---|
| Заголовок | storport.h |