Extensões de log de eventos do Storport

Como muitos outros tipos de drivers, os drivers de miniporto do Storport devem criar entradas no log de eventos do sistema para manter os administradores informados sobre a condição dos dispositivos de armazenamento anexados. Essas entradas de log de eventos geralmente são criadas em resposta a falhas relacionadas ao dispositivo. Os eventos também podem ser registrados para telemetria, depuração e otimização.

Embora o kernel do Windows em si forneça uma interface flexível para criar entradas de log de eventos, o modelo de miniporto storport não permite que drivers de miniporte acessem essa interface diretamente. Em vez disso, o Storport fornece um wrapper em torno do recurso de log de eventos do sistema do kernel e os drivers de miniport usam o wrapper para criar entradas de log de eventos.

Especificamente, o Storport fornece as seguintes rotinas de log de eventos:

• StorPortLogTelemetryEx permite que um miniporto registre um evento de telemetria ou medidas de log de rastreamento com dados personalizados por miniport (Windows 10 versão 1903 e mais recente).
• StorPortEtwChannelEvent2, StorPortEtwChannelEvent4 e StorPortEtwChannelEvent8 permitem que os miniportos publiquem eventos ETW em um canal de rastreamento de armazenamento (Windows 10 versão 1809 e mais recente).
• StorPortLogSystemEvent permite que miniportos criem uma entrada de log de eventos (Windows 7 e mais recente).

O Storport registra eventos no nome do provedor "Microsoft-Windows-Storage-Storport". Os erros são registrados no canal Operacional e a depuração/análise é registrada em Diagnosticar (Análise e Depuração). Ao usar o aplicativo Visualizador de Eventos, primeiro você deve habilitar o canal Diagnosticar para exibi-lo (para habilitar, clique em Exibir-Mostrar Logs analíticos> e de depuração).

As funções acima são implementadas como funções estendidas do Storport e estão disponíveis para miniportar drivers usando a interface de função estendida existente. O uso da interface de função estendida evita uma referência de link dinâmico direto à nova função. Ao evitar essa referência direta, os drivers de miniport que usam a nova função são carregados corretamente em sistemas operacionais que não dão suporte à função, com a função retornando STOR_STATUS_NOT_IMPLEMENTED quando não há suporte. Dessa forma, os fornecedores podem criar um único driver de miniporto executado em várias versões do sistema operacional, aproveitando a nova função de registro em log de eventos em que há suporte.

Nota: Em versões do Storport anteriores ao Windows 7, a interface de log de eventos do sistema do Storport, StorPortLogError, deu aos drivers de miniport acesso a uma pequena fração dos recursos do recurso de log de eventos do sistema do kernel, o que afeta a utilidade das entradas de log de eventos de miniport.

Para obter informações gerais sobre eventos do Windows, consulte Eventos do Windows.