StorPortLogTelemetry-Funktion (storport.h)

Artikel
02/26/2024

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
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 eventBufferLength/EventBuffer in der Ereignisstruktur nicht übereinstimmend.
STOR_STATUS_NOT_IMPLEMENTED	Diese Funktion ist auf dem aktiven Betriebssystem nicht implementiert.
STATUS_SUCCESS	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

Weitere Informationen

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx

Freigeben über