Функция 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 | Event->EventBufferLength больше EVENT_BUFFER_MAX_LENGTH. |
| STOR_STATUS_INVALID_PARAMETER | Указатель на один из параметров имеет значение NULL или для EventBufferLength задано значение null для Event->EventBuffer. |
| STOR_STATUS_NOT_IMPLEMENTED | Эта функция не реализована в активной операционной системе. |
| STOR_STATUS_SUCCESS | Событие телеметрии успешно зарегистрировано. |
Замечания
Минипорт может вызывать StorPortLogTelemetryEx регистрировать меры трассировки или событие телеметрии с помощью минипорта настраиваемых данных. Минипорты указывают тип категории событий в категории.
Данные события инкапсулируются в структуре STORPORT_TELEMETRY_EVENT, к которой точки событий. Минипорт может записывать восемь пар имени общего назначения и буфер, имеющий максимальную длину 4 КБ, а также несколько полей, связанных с событиями.
Требования
| Требование | Ценность |
|---|---|
| заголовка | storport.h |