Funzione StorPortLogTelemetry (storport.h)
Il StorPortLogTelemetry routine registra un evento di telemetria miniport per diagnosticare o raccogliere informazioni utili. 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 definiti nella struttura STORPORT_TELEMETRY_EVENT.
Sintassi
ULONG StorPortLogTelemetry(
[in] PVOID HwDeviceExtension,
[in, optional] PSTOR_ADDRESS StorAddress,
[in] PSTORPORT_TELEMETRY_EVENT Event
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo hardware per la scheda bus host (HBA).
[in, optional] StorAddress
Indirizzo del dispositivo dell'unità di archiviazione. Questo parametro è NULL per i dispositivi adattatori.
[in] Event
Puntatore alla struttura STORPORT_TELEMETRY_EVENT che contiene il payload dei dati di telemetria.
Valore restituito
storPortLogTelemetry restituisce uno dei codici di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
|
EventBufferLength è maggiore di EVENT_BUFFER_MAX_LENGTH. |
|
Un puntatore a uno dei parametri è NULL o EventBufferLength/EventBuffer nella struttura event non corrispondente. |
|
Questa funzione non viene implementata nel sistema operativo attivo. |
|
I dati dell'evento di telemetria sono stati registrati correttamente. |
Osservazioni
Se un parametro nella struttura Event non è denominato, Event->ParameterNameX == NULL, la routine imposta il valore del parametro corrispondente su 0.
Se miniport non ha payload da compilare event->EventBuffer, deve impostare Event->EventBufferLength = 0, nonché Event->EventBuffer = NULL.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10, versione 1703 |
| server minimo supportato | Windows Server 2016 |
| piattaforma di destinazione | Finestre |
| intestazione | storport.h (include Storport.h) |
| IRQL | Qualunque |