Funzione StorPortLogTelemetryEx (storport.h)
Il StorPortLogTelemetry routine registra un evento di telemetria miniport per diagnosticare o raccogliere informazioni utili.
Sintassi
ULONG StorPortLogTelemetryEx(
PVOID HwDeviceExtension,
PSTOR_ADDRESS StorAddress,
PSTORPORT_TELEMETRY_EVENT Event,
STOR_TELEMETRY_CATEGORY Category
);
Parametri
HwDeviceExtension
Puntatore all'estensione del dispositivo hardware per l'adattatore bus host (HBA).
StorAddress
Indirizzo del dispositivo di unità di archiviazione. Questo parametro è NULL per i dispositivi adattatori.
Event
Puntatore alla struttura STORPORT_TELEMETRY_EVENT che contiene il payload dei dati di telemetria.
Category
STOR_TELEMETRY_CATEGORY valore di enumerazione che specifica la categoria di dati di telemetria da registrare.
Valore restituito
StorPortLogTelemetryEx restituisce uno dei codici di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
| STOR_STATUS_INVALID_BUFFER_SIZE | Event-> EventBufferLength è maggiore di EVENT_BUFFER_MAX_LENGTH. |
| STOR_STATUS_INVALID_PARAMETER | Un puntatore a uno dei parametri è NULL o EventBufferLength è impostato su zero per un Event->EventBuffer. |
| STOR_STATUS_NOT_IMPLEMENTED | Questa funzione non viene implementata nel sistema operativo attivo. |
| STOR_STATUS_SUCCESS | L'evento di telemetria è stato registrato correttamente. |
Osservazioni
Un miniport può chiamare StorPortLogTelemetryEx per registrare misure di traccia o eventi di telemetria con dati personalizzati con miniport. I miniport specificano il tipo di categoria di eventi in Categoria.
I dati dell'evento vengono incapsulati nella struttura di STORPORT_TELEMETRY_EVENT in cui punti evento. Il miniport può registrare otto coppie nome-valore per utilizzo generico e un buffer con lunghezza massima di 4 KB, nonché diversi campi correlati agli eventi.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | storport.h |