Storport-Ereignisprotokollerweiterungen
Wie viele andere Treibertypen müssen Storport-Miniporttreiber Einträge im Systemereignisprotokoll erstellen, um Administratoren über den Zustand angefügter Speichergeräte auf dem Laufenden zu halten. Diese Ereignisprotokolleinträge werden häufig als Reaktion auf gerätebezogene Fehler erstellt. Ereignisse können auch für Telemetrie, Debuggen und Optimierung protokolliert werden.
Obwohl der Windows-Kernel selbst eine flexible Schnittstelle zum Erstellen von Ereignisprotokolleinträgen bietet, lässt das Storport-Miniportmodell nicht zu, dass Miniporttreiber direkt auf diese Schnittstelle zugreifen können. Stattdessen stellt Storport einen Wrapper für die Systemereignisprotokollfunktion des Kernels bereit, und Miniporttreiber verwenden den Wrapper, um Ereignisprotokolleinträge zu erstellen.
Insbesondere stellt Storport die folgenden Ereignisprotokollroutinen bereit:
- StorPortLogTelemetryEx ermöglicht einem Miniport das Protokollieren von Ablaufverfolgungsmeasures oder Telemetrieereignissen mit durch Miniport angepassten Daten (Windows 10 Version 1903 und höher).
- StorPortEtwChannelEvent2, StorPortEtwChannelEvent4 und StorPortEtwChannelEvent8 ermöglichen Miniports das Veröffentlichen von ETW-Ereignissen in einem Speicherablaufverfolgungskanal (Windows 10 Version 1809 und höher).
- StorPortLogSystemEvent ermöglicht Miniports das Erstellen eines Ereignisprotokolleintrags (Windows 7 und höher).
Storport protokolliert Ereignisse unter dem Anbieternamen "Microsoft-Windows-Storage-Storport". Fehler werden im Betriebskanal protokolliert, und Debuggen/Analysen werden unter Diagnose (Analyse und Debuggen) protokolliert. Wenn Sie die Ereignisanzeige-Anwendung verwenden, müssen Sie zuerst den Diagnosekanal aktivieren, um ihn anzuzeigen (klicken Sie zum Aktivieren auf Analyse-> und Debugprotokolle anzeigen).
Die oben genannten Funktionen werden als erweiterte Storport-Funktionen implementiert und stehen für Miniporttreiber über die vorhandene erweiterte Funktionsschnittstelle zur Verfügung. Durch die Verwendung der erweiterten Funktionsschnittstelle wird ein direkter dynamischer Linkverweis auf die neue Funktion vermieden. Indem Sie diesen direkten Verweis vermeiden, laden Miniporttreiber, die die neue Funktion verwenden, ordnungsgemäß auf Betriebssystemen, die die Funktion nicht unterstützen, und die Funktion gibt STOR_STATUS_NOT_IMPLEMENTED zurück, wenn sie nicht unterstützt wird. Auf diese Weise können Anbieter einen einzelnen Miniporttreiber erstellen, der auf mehreren Betriebssystemversionen ausgeführt wird, und nutzen dabei die neue Ereignisprotokollierungsfunktion, in der sie unterstützt wird.
Hinweis: In Storport-Versionen vor Windows 7 gewährte Storports Systemereignisprotokollschnittstelle StorPortLogError Miniport-Treibern Zugriff auf einen kleinen Teil der Funktionen der Systemereignisprotokollfunktion des Kernels, was sich auf die Nützlichkeit von Miniport-Ereignisprotokolleinträgen auswirkt.
Allgemeine Informationen zu Windows-Ereignissen finden Sie unter Windows-Ereignisse.