Extensions du journal des événements Storport
Comme de nombreux autres types de pilotes, les pilotes miniport Storport doivent créer des entrées dans le journal des événements système pour tenir les administrateurs informés de la condition des périphériques de stockage attachés. Ces entrées de journal des événements sont souvent créées en réponse à des défaillances liées à l’appareil. Les événements peuvent également être consignés pour la télémétrie, le débogage et l’optimisation.
Bien que le noyau Windows lui-même fournisse une interface flexible pour la création d’entrées de journal des événements, le modèle de miniport Storport n’autorise pas les pilotes miniport à accéder directement à cette interface. Au lieu de cela, Storport fournit un wrapper autour de la fonctionnalité de journal des événements système du noyau, et les pilotes miniport utilisent le wrapper pour créer des entrées de journal des événements.
Plus précisément, Storport fournit les routines de journal des événements suivantes :
- StorPortLogTelemetryEx permet à un miniport de journaliser des mesures de suivi ou un événement de télémétrie avec des données personnalisées (Windows 10 version 1903 et ultérieures).
- StorPortEtwChannelEvent2, StorPortEtwChannelEvent4 et StorPortEtwChannelEvent8 permettent aux miniports de publier des événements ETW sur un canal de trace de stockage (Windows 10 version 1809 et ultérieure).
- StorPortLogSystemEvent permet aux miniports de créer une entrée de journal des événements (Windows 7 et versions ultérieures).
Storport journalise les événements sous le nom du fournisseur « Microsoft-Windows-Storage-Storport ». Les erreurs sont enregistrées dans le canal opérationnel , et debug/analytics sont enregistrés dans Diagnostiquer (Analytique et Débogage). Lorsque vous utilisez l’application observateur d'événements, vous devez d’abord activer le canal Diagnostiquer pour l’afficher (pour l’activer, cliquez sur Afficher-Afficher> les journaux d’analyse et de débogage).
Les fonctions ci-dessus sont implémentées en tant que fonctions étendues Storport et sont disponibles pour les pilotes miniport à l’aide de l’interface de fonction étendue existante. L’utilisation de l’interface de fonction étendue évite une référence de liaison dynamique directe à la nouvelle fonction. En évitant cette référence directe, les pilotes miniport qui utilisent la nouvelle fonction se chargent correctement sur les systèmes d’exploitation qui ne prennent pas en charge la fonction, la fonction retournant STOR_STATUS_NOT_IMPLEMENTED lorsqu’elle n’est pas prise en charge. De cette façon, les fournisseurs peuvent créer un seul pilote miniport qui s’exécute sur plusieurs versions de système d’exploitation, en tirant parti de la nouvelle fonction de journalisation des événements où elle est prise en charge.
Note: Dans les versions de Storport antérieures à Windows 7, l’interface de journal des événements système de Storport, StorPortLogError, permettait aux pilotes miniport d’accéder à une petite fraction des fonctionnalités de la fonctionnalité de journal des événements système du noyau, ce qui a un impact sur l’utilité des entrées du journal des événements miniport.
Pour obtenir des informations générales sur les événements Windows, consultez Événements Windows.