Función StorPortLogTelemetryEx (storport.h)

Artículo
02/26/2024

La rutina StorPortLogTelemetry registra un evento de telemetría de miniporte para ayudar a diagnosticar o recopilar información útil.

Sintaxis

ULONG StorPortLogTelemetryEx(
  PVOID                     HwDeviceExtension,
  PSTOR_ADDRESS             StorAddress,
  PSTORPORT_TELEMETRY_EVENT Event,
  STOR_TELEMETRY_CATEGORY   Category
);

Parámetros

HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

StorAddress

Dirección del dispositivo de unidad de almacenamiento. Este parámetro es NULL para dispositivos adaptadores.

Event

Puntero a la estructura STORPORT_TELEMETRY_EVENT que contiene la carga de datos de telemetría.

Category

STOR_TELEMETRY_CATEGORY valor de enumeración que especifica la categoría de telemetría que se va a registrar.

Valor devuelto

StorPortLogTelemetryEx devuelve uno de los siguientes códigos de estado:

Código devuelto	Descripción
STOR_STATUS_INVALID_BUFFER_SIZE	Evento->EventBufferLength es mayor que EVENT_BUFFER_MAX_LENGTH.
STOR_STATUS_INVALID_PARAMETER	Un puntero a uno de los parámetros es NULL o EventBufferLength se establece en cero para un event-EventBuffer> distinto de NULL.
STOR_STATUS_NOT_IMPLEMENTED	Esta función no se implementa en el sistema operativo activo.
STOR_STATUS_SUCCESS	El evento de telemetría se registró correctamente.

Comentarios

Un minipuerto puede llamar a StorPortLogTelemetryEx para registrar una medida de registro de seguimiento o un evento de telemetría con datos personalizados de miniporte. Los miniportes especifican el tipo de categoría de evento en Categoría.

Los datos del evento se encapsulan en la estructura STORPORT_TELEMETRY_EVENT a la que apunta event . El minipuerto puede registrar ocho pares nombre-valor de uso general y un búfer con una longitud máxima de 4 KB, así como varios campos relacionados con eventos.