Función StorPortLogTelemetryEx (storport.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Header | storport.h |