StorPortLogTelemetryEx-Funktion (storport.h)
Die StorPortLogTelemetry-Routine protokolliert ein Miniporttelemetrieereignis , um nützliche 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 Host Bus Adapter (HBA).
StorAddress
Geräteadresse der Speichereinheit. Dieser Parameter ist NULL für Adaptergeräte.
Event
Zeiger auf die STORPORT_TELEMETRY_EVENT-Struktur , die die Telemetriedatennutzlast enthält.
Category
STOR_TELEMETRY_CATEGORY Enumerationswert, der die Kategorie der zu protokollierenden Telemetriedaten angibt.
Rückgabewert
StorPortLogTelemetryEx gibt einen der folgenden status-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STOR_STATUS_INVALID_BUFFER_SIZE | Ereignis->EventBufferLength ist größer als EVENT_BUFFER_MAX_LENGTH. |
| STOR_STATUS_INVALID_PARAMETER | Ein Zeiger auf einen der Parameter ist NULL, oder eventBufferLength ist für ein Ereignis-EventBuffer> ohne NULL auf Null festgelegt. |
| STOR_STATUS_NOT_IMPLEMENTED | Diese Funktion ist auf dem aktiven Betriebssystem nicht implementiert. |
| STOR_STATUS_SUCCESS | Das Telemetrieereignis wurde erfolgreich protokolliert. |
Hinweise
Ein Miniport kann StorPortLogTelemetryEx aufrufen, um ein Tracelogging-Measures oder Telemetrieereignis mit durch Miniport angepassten Daten zu protokollieren. Miniports geben den Ereigniskategorietyp in Kategorie an.
Die Ereignisdaten werden in der STORPORT_TELEMETRY_EVENT Struktur gekapselt, auf die Event verweist. Der Miniport kann acht allgemeine Name-Wert-Paare und einen Puffer mit einer maximalen Länge von 4 KB sowie mehrere ereignisbezogene Felder protokollieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | storport.h |