StorPortLogTelemetry-Funktion (storport.h)

Artikel
02/07/2025

Die StorPortLogTelemetry Routine protokolliert ein Miniport-Telemetrieereignis, um hilfreiche Informationen zu diagnostizieren oder zu sammeln. Der Miniport kann acht allgemeine Namenswertpaare und einen Puffer mit maximaler Länge von 4 KB sowie mehrere ereignisbezogene Felder protokollieren, die in strukturbezogener STORPORT_TELEMETRY_EVENTdefiniert 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 Hostbusadapter (HBA).

[in, optional] StorAddress

Die Adresse des Speichergeräts. Dieser Parameter ist NULL für Adaptergeräte.

[in] Event

Zeigen Sie auf die STORPORT_TELEMETRY_EVENT Struktur, die die Telemetriedatennutzlast enthält.

Rückgabewert

StorPortLogTelemetry- gibt einen der folgenden Statuscodes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_INVALID_BUFFER_SIZE	EventBufferLength- ist größer als EVENT_BUFFER_MAX_LENGTH.
STOR_STATUS_INVALID_PARAMETER	Ein Zeiger auf einen der Parameter ist NULL oder der EventBufferLength/EventBuffer in der Ereignisstruktur nicht übereinstimmend.
STOR_STATUS_NOT_IMPLEMENTED	Diese Funktion ist nicht auf dem aktiven Betriebssystem implementiert.
STATUS_SUCCESS	Die Telemetrieereignisdaten wurden erfolgreich protokolliert.

Bemerkungen

Wenn ein Parameter in der Ereignisstruktur nicht benannt ist>, legt die Routine den entsprechenden Parameterwert auf 0 fest.

Wenn miniport keine Nutzlast zum Ausfüllen von Event->EventBuffer hat, sollte event->EventBufferLength = 0 sowie Event->EventBuffer = NULL festgelegt werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1703
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Header-	storport.h (include Storport.h)
IRQL-	Jegliche

Siehe auch

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx-

Freigeben über