Freigeben über


StorPortLogTelemetryEx-Funktion (storport.h)

Die StorPortLogTelemetry Routine protokolliert ein Miniport-Telemetrieereignis, um hilfreiche Informationen zu diagnostizieren oder zu sammeln.

Syntax

ULONG StorPortLogTelemetryEx(
  PVOID                     HwDeviceExtension,
  PSTOR_ADDRESS             StorAddress,
  PSTORPORT_TELEMETRY_EVENT Event,
  STOR_TELEMETRY_CATEGORY   Category
);

Parameter

HwDeviceExtension

Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA).

StorAddress

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

Event

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

Category

STOR_TELEMETRY_CATEGORY Enumerationswert, der die Kategorie der zu protokollierenden Telemetrie angibt.

Rückgabewert

StorPortLogTelemetryEx gibt einen der folgenden Statuscodes zurück:

Rückgabecode Beschreibung
STOR_STATUS_INVALID_BUFFER_SIZE Event->EventBufferLength ist größer als EVENT_BUFFER_MAX_LENGTH.
STOR_STATUS_INVALID_PARAMETER Ein Zeiger auf einen der Parameter ist NULL, oder der EventBufferLength wird für einen Nicht-NULL-Event->EventBuffer-auf Null festgelegt.
STOR_STATUS_NOT_IMPLEMENTED Diese Funktion ist nicht auf dem aktiven Betriebssystem implementiert.
STOR_STATUS_SUCCESS Das Telemetrieereignis wurde erfolgreich protokolliert.

Bemerkungen

Ein Miniport kann StorPortLogTelemetryEx- aufrufen, um ein Tracelogging-Measures oder Telemetrieereignis mit miniportspezifischen Daten zu protokollieren. Miniports geben den Ereigniskategorietyp in Kategoriean.

Die Ereignisdaten werden in der STORPORT_TELEMETRY_EVENT Struktur gekapselt, auf die Event Punkte verweist. Der Miniport kann acht allgemeine Namenswertpaare und einen Puffer protokollieren, der eine maximale Länge von 4 KB sowie mehrere ereignisbezogene Felder aufweist.

Anforderungen

Anforderung Wert
Header- storport.h

Siehe auch

STOR_TELEMETRY_CATEGORY

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetry-