Compartir a través de

Función StorPortLogTelemetry (storport.h)

  • Artículo

La rutina StorPortLogTelemetry registra un evento de telemetría de miniport para ayudar a diagnosticar o recopilar información útil. 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 definidos en la estructura STORPORT_TELEMETRY_EVENT.

Sintaxis

ULONG StorPortLogTelemetry(
  [in]           PVOID                     HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS             StorAddress,
  [in]           PSTORPORT_TELEMETRY_EVENT Event
);

Parámetros

[in] HwDeviceExtension

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

[in, optional] StorAddress

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

[in] Event

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

Valor devuelto

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

Código devuelto Descripción
STOR_STATUS_INVALID_BUFFER_SIZE
 EventBufferLength es mayor que EVENT_BUFFER_MAX_LENGTH.
STOR_STATUS_INVALID_PARAMETER
 Un puntero a uno de los parámetros es NULL o EventBufferLength/EventBuffer en la estructura event no coincide.
STOR_STATUS_NOT_IMPLEMENTED
 Esta función no se implementa en el sistema operativo activo.
STATUS_SUCCESS
 Los datos del evento de telemetría se han registrado correctamente.

Comentarios

Si no se llama a algún parámetro de la estructura Event, Event-ParameterNameX> == NULL, la rutina establecerá el valor de parámetro correspondiente en 0.

Si miniport no tiene ninguna carga para rellenar Event-EventBuffer>, debe establecer Event-EventBufferLength> = 0, así como Event-EventBuffer> = NULL.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1703
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Encabezado storport.h (incluya Storport.h)
IRQL Any

Consulte también

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx