StorPortNvmeLogTelemetry-Funktion (storport.h)
Ein NMVe-Miniport-Treiber ruft die StorPortNvmeLogTelemetry--Funktion auf, um Telemetrieereignisse für ein NVMe-Gerät zu protokollieren.
Syntax
ULONG StorPortNvmeLogTelemetry(
PVOID HwDeviceExtension,
PVOID ControllerHandle,
ULONG NamespaceId,
PSTORPORT_TELEMETRY_EVENT Event,
STOR_TELEMETRY_CATEGORY Category
);
Parameter
HwDeviceExtension
[in] Ein Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA).
ControllerHandle
[in/optional] Bei einem Fabric NVMe-Miniport, wenn das Ereignis controllerspezifisch ist, ControllerHandle- das Handle von StorPort für den NVMe-Controller ist. Andernfalls sollte ControllerHandle- NULL sein.
NamespaceId
[in] Wenn das Ereignis namespacespezifisch ist, ist NamespaceId der Namespacebezeichner. Andernfalls sollte NamespaceId 0 sein.
Event
[in] Zeigen Sie auf eine STORPORT_TELEMTRY_EVENT Struktur, die Standardereignisfelder und Miniportnutzlastdaten enthält.
Category
[in] Ein STOR_TELEMETRY_CATEGORY Wert, der die zu protokollierende Telemetriekategorie angibt.
Rückgabewert
StorPortNvmeLogTelemetry gibt STOR_STATUS_SUCCESS zurück, wenn das Telemetrieereignis erfolgreich protokolliert wurde. Andernfalls wird ein STOR_STATUS Fehlercode zurückgegeben, z. B. folgendes:
| Rückgabecode | Beschreibung |
|---|---|
| STOR_STATUS_NOT_IMPLEMENTED | Diese Funktion ist nicht auf dem aktiven Betriebssystem implementiert. |
| STOR_STATUS_INVALID_PARAMETER | Der Vorgang schlägt mit diesem Rückgabewert fehl, wenn mindestens ein Parameter ungültig ist. |
Bemerkungen
Ein NVMe-Miniport kann diese Funktion aufrufen, um ein Tracelogging Measures-Ereignis mit miniportspezifischen Daten zu protokollieren, die in Eventgekapselt werden.
StorPortNvmeLogTelemetry- ermöglicht es dem Anrufer zusätzlich, einen Typ der Telemtrykategorie anzugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 11, Version 24H2 |
| Header- | storport.h |