Función StorPortLogTelemetry (storport.h)
El StorPortLogTelemetry rutina registra un evento de telemetría de miniportar 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 |
|---|---|
|
EventBufferLength es mayor que EVENT_BUFFER_MAX_LENGTH. |
|
Un puntero a uno de los parámetros es NULL o EventBufferLength/EventBuffer en la estructura event no coincide. |
|
Esta función no se implementa en el sistema operativo activo. |
|
Los datos del evento de telemetría se han registrado correctamente. |
Observaciones
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 carga para rellenar Event->EventBuffer, debe establecer Event->EventBufferLength = 0, así como Event->EventBuffer = NULL.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1703 |
| servidor mínimo admitido | Windows Server 2016 |
| de la plataforma de destino de | Windows |
| encabezado de | storport.h (incluya Storport.h) |
| irQL | Cualquier |