StorPortLogTelemetry-Funktion (storport.h)
Die StorPortLogTelemetry-Routine protokolliert ein Miniporttelemetrieereignis , um nützliche Informationen zu diagnostizieren oder zu sammeln. Der Miniport kann acht universelle Name-Wert-Paare und einen Puffer mit einer maximalen Länge von 4 KB sowie mehrere ereignisbezogene Felder protokollieren, die in der Struktur STORPORT_TELEMETRY_EVENT definiert sind.
Syntax
ULONG StorPortLogTelemetry(
[in] PVOID HwDeviceExtension,
[in, optional] PSTOR_ADDRESS StorAddress,
[in] PSTORPORT_TELEMETRY_EVENT Event
);
Parameter
[in] HwDeviceExtension
Ein Zeiger auf die Hardwaregeräteerweiterung für den Host Bus Adapter (HBA).
[in, optional] StorAddress
Die Geräteadresse der Speichereinheit. Dieser Parameter ist NULL für Adaptergeräte.
[in] Event
Zeiger auf die STORPORT_TELEMETRY_EVENT Struktur, die die Telemetriedatennutzlast enthält.
Rückgabewert
StorPortLogTelemetry gibt einen der folgenden status Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
EventBufferLength ist größer als EVENT_BUFFER_MAX_LENGTH. |
|
Ein Zeiger auf einen der Parameter ist NULL oder eventBufferLength/EventBuffer in der Ereignisstruktur nicht übereinstimmend. |
|
Diese Funktion ist auf dem aktiven Betriebssystem nicht implementiert. |
|
Die Telemetrieereignisdaten wurden erfolgreich protokolliert. |
Hinweise
Wenn kein Parameter in der Ereignisstruktur benannt ist, Event-ParameterNameX> == NULL, legt die Routine den entsprechenden Parameterwert auf 0 fest.
Wenn der Miniport über keine Nutzlast zum Ausfüllen von Event-EventBuffer> verfügt, sollte event-EventBufferLength> = 0 sowie Event-EventBuffer> = NULL festgelegt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1703 |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Zielplattform | Windows |
| Kopfzeile | storport.h (einschließlich Storport.h) |
| IRQL | Any |