Funzione StorPortNvmeLogTelemetry (storport.h)
Un driver miniport NMVe chiama la funzione StorPortNvmeLogTelemetry per registrare gli eventi di telemetria per un dispositivo NVMe.
Sintassi
ULONG StorPortNvmeLogTelemetry(
PVOID HwDeviceExtension,
PVOID ControllerHandle,
ULONG NamespaceId,
PSTORPORT_TELEMETRY_EVENT Event,
STOR_TELEMETRY_CATEGORY Category
);
Parametri
HwDeviceExtension
[in] Puntatore all'estensione del dispositivo hardware per la scheda bus host (HBA).
ControllerHandle
[in/facoltativo] Per un miniport NVMe dell'infrastruttura, se l'evento è specifico del controller, ControllerHandle è l'handle di StorPort per il controller NVMe. In caso contrario, ControllerHandle deve essere NULL.
NamespaceId
[in] Se l'evento è specifico dello spazio dei nomi, NamespaceId è l'identificatore dello spazio dei nomi. In caso contrario, NamespaceId deve essere 0.
Event
[in] Puntatore a una struttura STORPORT_TELEMTRY_EVENT che contiene campi evento standard e dati di payload miniport.
Category
[in] Valore STOR_TELEMETRY_CATEGORY che specifica la categoria di telemetria da registrare.
Valore restituito
StorPortNvmeLogTelemetry restituisce STOR_STATUS_SUCCESS se l'evento di telemetria viene registrato correttamente. In caso contrario, restituisce un codice di errore STOR_STATUS, ad esempio:
| Codice restituito | Descrizione |
|---|---|
| STOR_STATUS_NOT_IMPLEMENTED | Questa funzione non viene implementata nel sistema operativo attivo. |
| STOR_STATUS_INVALID_PARAMETER | L'operazione non riesce con questo valore restituito se uno o più parametri non sono validi. |
Osservazioni
Un miniport NVMe può chiamare questa funzione per registrare un evento di tracciamento delle misure con dati personalizzati miniport incapsulati in Event.
StorPortNvmeLogTelemetry consente inoltre al chiamante di specificare un tipo di categoria di telemtry.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 11, versione 24H2 |
| intestazione | storport.h |