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

Статья
02/07/2025

Драйвер минипорта NMVe вызывает функцию StorPortNvmeLogTelemetry для записи событий телеметрии для устройства NVMe.

Синтаксис

ULONG StorPortNvmeLogTelemetry(
  PVOID                     HwDeviceExtension,
  PVOID                     ControllerHandle,
  ULONG                     NamespaceId,
  PSTORPORT_TELEMETRY_EVENT Event,
  STOR_TELEMETRY_CATEGORY   Category
);

Параметры

HwDeviceExtension

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

ControllerHandle

[in/необязательный] Для минипорта NVMe структуры, если событие зависит от контроллера, ControllerHandle — это дескриптор StorPort для контроллера NVMe. В противном случае ControllerHandle должно иметь значение NULL.

NamespaceId

[in] Если событие зависит от пространства имен, NamespaceId является идентификатором пространства имен. В противном случае NamespaceId должно иметь значение 0.

Event

[in] Указатель на структуру STORPORT_TELEMTRY_EVENT, содержащую стандартные поля событий и полезные данные мини-порта.

Category

[in] Значение STOR_TELEMETRY_CATEGORY, указывающее категорию телеметрии для журнала.

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

StorPortNvmeLogTelemetrySTOR_STATUS_SUCCESS возвращает STOR_STATUS_SUCCESS, если событие телеметрии успешно зарегистрировано. В противном случае возвращается код ошибки STOR_STATUS, например следующий:

Возвращаемый код	Описание
STOR_STATUS_NOT_IMPLEMENTED	Эта функция не реализована в активной операционной системе.
STOR_STATUS_INVALID_PARAMETER	Операция завершается ошибкой с этим возвращаемым значением, если один или несколько параметров недопустимы.

Замечания

Минипорт NVMe может вызвать эту функцию для записи события мер трассировки с помощью минипорта настраиваемых данных, инкапсулированных в Event.

storPortNvmeLogTelemetry дополнительно позволяет вызывающему объекту указать тип категории телемтери.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 11 версии 24H2
заголовка	storport.h

См. также

STOR_TELEMETRY_CATEGORY

STORPORT_TELEMTRY_EVENT

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