Estensioni del registro eventi Storport

Come molti altri tipi di driver, i driver miniport Storport devono creare voci nel registro eventi di sistema per mantenere gli amministratori informati della condizione dei dispositivi di archiviazione collegati. Queste voci del registro eventi vengono spesso create in risposta a errori correlati al dispositivo. Gli eventi possono anche essere registrati per la telemetria, il debug e l'ottimizzazione.

Anche se il kernel di Windows stesso fornisce un'interfaccia flessibile per la creazione di voci del registro eventi, il modello miniport Storport non consente ai driver miniport di accedere direttamente a tale interfaccia. Storport fornisce invece un wrapper intorno alla struttura del registro eventi di sistema del kernel e i driver miniport usano il wrapper per creare voci del registro eventi.

In particolare, Storport fornisce le routine del registro eventi seguenti:

• StorPortLogTelemetryEx consente a un miniport di registrare misure o eventi di telemetria di traccia con dati personalizzati miniport (Windows 10 versione 1903 e successive).
• StorPortEtwChannelEvent2, StorPortEtwChannelEvent4 e StorPortEtwChannelEvent8 consentono ai miniport di pubblicare eventi ETW in un canale di traccia di archiviazione (Windows 10 versione 1809 e successive).
• StorPortLogSystemEvent consente ai miniport di creare una voce del registro eventi (Windows 7 e versioni successive).

Storport registra gli eventi nel nome del provider "Microsoft-Windows-Storage-Storport". Gli errori vengono registrati nel canale operativo e il debug/analisi viene registrato in Diagnostica (analisi e debug). Quando si usa l'applicazione Visualizzatore eventi, è prima necessario abilitare il canale Diagnostica per visualizzarlo(per abilitarlo, fare clic su Visualizza-Mostra> log analitici e di debug).

Le funzioni precedenti vengono implementate come funzioni estese storport e sono disponibili per i driver miniport usando l'interfaccia di funzione estesa esistente. L'uso dell'interfaccia della funzione estesa evita un riferimento di collegamento dinamico diretto alla nuova funzione. Evitando tale riferimento diretto, i driver miniport che usano correttamente il carico della nuova funzione nei sistemi operativi che non supportano la funzione, con la funzione che restituisce STOR_STATUS_NOT_IMPLEMENTED quando non è supportato. In questo modo, i fornitori possono creare un singolo driver miniport in esecuzione in più versioni del sistema operativo, sfruttando la nuova funzione di registrazione degli eventi in cui è supportata.

Nota: Nelle versioni di Storport precedenti a Windows 7, l'interfaccia del registro eventi di sistema di Storport, StorPortLogError, ha concesso ai driver miniport l'accesso a una piccola frazione delle funzionalità della funzionalità del registro eventi di sistema del kernel, che influisce sull'utilità delle voci del registro eventi miniport.

Per informazioni generali sugli eventi di Windows, vedere Eventi di Windows.