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

Драйвер минипорта 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_TELEMETRY_EVENT , содержащую стандартные поля событий и полезные данные минипорта.

Category

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

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

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

Замечания

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

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

Требования

См. также

STOR_TELEMETRY_CATEGORY

STORPORT_TELEMETRY_EVENT