Funzione StorPortLogTelemetryEx (storport.h)
La routine StorPortLogTelemetry registra un evento di telemetria di miniport per facilitare la diagnosi o la raccolta di 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 la scheda bus host (HBA).
StorAddress
Indirizzo del dispositivo dell'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 | Evento->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> non NULL. |
STOR_STATUS_NOT_IMPLEMENTED | Questa funzione non viene implementata nel sistema operativo attivo. |
STOR_STATUS_SUCCESS | L'evento di telemetria è stato registrato correttamente. |
Commenti
Un miniport può chiamare StorPortLogTelemetryEx per registrare misure di traccia o eventi di telemetria con dati personalizzati miniport. I miniport specificano il tipo di categoria di eventi in Categoria.
I dati dell'evento vengono incapsulati nella struttura STORPORT_TELEMETRY_EVENT a cui punta Event . Il miniport può registrare otto coppie nome-valore per utilizzo generico e un buffer con una lunghezza massima di 4 KB, nonché diversi campi correlati agli eventi.
Requisiti
Requisito | Valore |
---|---|
Intestazione | storport.h |