Feedback avviato dall'utente - modalità normale

Nello scenario UIF (User-Initiated Feedback) normale, un utente riscontra un problema con Wi-Fi e invia un report di feedback. Questo report raccoglie uno snapshot del sottosistema Wi-Fi, inclusi i logger automatici WMI di Wi-Fi, statistiche di rete, ecc. Per raccogliere log specifici di IHV, Microsoft fornisce una sessione di logger automatici WMI senza provider ETW iniziali configurati. Ogni IHV aggiunge il proprio set di provider ETW alla voce del registro di sistema della sessione di auto-logger WMI fornita da Microsoft. Quando viene inviato il report UIF, l'ETL automatico IHV viene raccolto e inviato a Microsoft per l'analisi. Questo file di log viene implementato usando un buffer circolare con dimensioni leggermente limitate (<= 1 MB). Gli eventi salvati in questo file di log devono essere limitati in modo appropriato tramite flag/livello/parole chiave per garantire che vengano sempre salvati almeno gli ultimi 30 minuti degli eventi del log.

Sessione del logger automatico WMI fornita da Microsoft

Microsoft fornisce una sessione WMI di tracciamento automatico senza provider ETW iniziali. Quando vengono installati i driver IHV, è necessario aggiungere le chiavi del Registro di sistema del provider WMI necessarie sotto la chiave della sessione del logger automatico WMI fornita da Microsoft. L'IHV non deve modificare i valori del Registro di sistema delle sessioni dei logger automatici. Tuttavia, tutte le opzioni del provider ETW sono disponibili per l'IHV, incluso il livello di abilitazione, la corrispondenza con uno qualsiasi, la corrispondenza con tutti, e così via. Questa sessione di registrazione viene sempre eseguita e ha un buffer circolare limitato, pertanto gli IHV devono impostare il provider EnableLevels in modo appropriato.

La sessione auto-logger WMI viene aggiunta all'hive del registro di sistema HKLM con il percorso seguente:

HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession

Il file di log ETL risultante si trova qui:

%SystemDrive%\System32\LogFiles\WMI\WifiDriverIHVSession.etl

Modifiche INF del driver IHV

Gli IHV devono aggiornare i file INF del driver per aggiungere i seguenti valori chiave del registro, così da ottenere registri dettagliati di IHV durante la modalità normale UIF. I frammenti di codice seguenti forniscono un modello per l'aggiunta di un singolo provider ETW alla sessione del logger automatico. Un IHV può aggiungere il numero di provider che ritiene opportuno. Inoltre, i valori del livello di abilitazione sono specifici di IHV per provider ETW, quindi non devono necessariamente essere uguali ai valori definiti da Microsoft (TRACE_LEVEL_CRITICAL, TRACE_LEVEL_ERROR e così via).

Abilitare la sessione di auto-logger IHV

Poiché la sessione di auto-logger IHV viene inizializzata senza provider ETW, è disabilitata per impostazione predefinita. Gli produttori indipendenti di hardware sono tenuti ad abilitare questa sessione aggiornando il valore "Start" a 1 nel file INF del driver, come illustrato in questo esempio:

HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession,Start,%REG_DWORD%,1

Aggiungere provider IHV ETW

Il frammento di codice seguente illustra come aggiungere provider IHV ETW nel file INF:

HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\<IHVProviderGUID_1>,Enabled,%REG_DWORD%,1
HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\<IHVProviderGUID_1>,,EnableLevel,%REG_DWORD%,<IHV_LogEnableLevelValue>
HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\<IHVProviderGUID_1>,MatchAnyKeyword,%REG_QWORD%,<IHV_MatchAnyKewordValue>

[The following is optional]
HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\<IHVProviderGUID_1>,MatchAllKeyword,%REG_QWORD%,<IHV_MatchAllKewordValue>

[Strings]
REG_DWORD = 0x00010001
REG_QWORD = 0x000B0001

Valori di esempio

Questo esempio illustra un'impostazione del livello nativo Wi-Fi personalizzata (abilita tutto) con tutte le parole chiave native Wi-Fi:

HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\{0BD3506A-9030-4f76-9B88-3E8FE1F7CFB6},Enabled,%REG_DWORD%,1
HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\{0BD3506A-9030-4f76-9B88-3E8FE1F7CFB6},,EnableLevel,%REG_DWORD%,0x04
HKLM,SYSTEM\CurrentControlSet\Control\WMI\Autologger\WifiDriverIHVSession\{0BD3506A-9030-4f76-9B88-3E8FE1F7CFB6},MatchAnyKeyword,%REG_QWORD%,0x000FFFFF

Standard EnableLevel values:
0x5 - Verbose
0x4 - Informational
0x3 - Warning
0x2 - Error
0x1 - Critical
0x0 – LogAlways

Collegamenti correlati

Feedback avviato dall'utente con registrazione delle tracce IHV

Feedback avviato dall'utente - Modalità di riproduzione