Abilitazione dell'inserimento di errori

Lo strumento WdfTester fornisce un'interfaccia WMI per configurare l'iniezione di errori DDI per un driver specifico. Viene fornito uno script (WdftesterScript.wsf) che usa questa interfaccia WMI per configurare l'inserimento degli errori. È possibile scrivere uno script personalizzato o usare lo script fornito per abilitare l'inserimento degli errori. È possibile eseguire uno script (WdftesterScript.wsf) da una finestra del prompt dei comandi per registrare, configurare e annullare la registrazione di un driver. Lo script include anche un'opzione della riga di comando denominata runtest.

Cosa fa l'opzione runtest

L'opzione runtest esegue semplici operazioni di disabilitazione e abilitazione su un driver. Questa opzione illustra come usare lo strumento. In un primo momento, lo script disabilita il driver specificato e quindi lo abilita. Ciò consente a WdfTester di monitorare tutte le chiamate DDI effettuate durante le operazioni di disabilitazione e abilitazione. Lo script usa una delle interfacce WMI per ottenere l'elenco delle DDI chiamate durante questo periodo. Lo script determina quale di queste DDI potrebbero essere non riuscite (solo quelle che restituiscono NTSTATUS). Lo script chiama quindi un'altra interfaccia WMI per configurare WdfTester in modo che non riesca la prima DDI nell'elenco. Lo script disabilita e abilita il driver, il che provoca il fallimento della DDI e genera un evento WMI. Lo script è già in attesa dell'evento di errore WMI per il DDI. Se l'evento viene ricevuto correttamente e l'errore non ha causato la mancata risposta del computer o la causa di un controllo dei bug (come determinato dallo sviluppatore o dal tester del driver) il test viene considerato riuscito. Lo script ripete quindi questi passaggi per la successiva DDI nell'elenco.

Nota L'opzione runtest richiede di copiare lo strumento DevCon (Devcon.exe) e inserirlo nella stessa directory degli altri file Wdftester. L'applicazione Devcon.exe si trova nella directory %WDKRoot%\tools\<platform> .

Opzione runtest:

1. Registra il driver con WdfTester. Se il driver non è stato installato, è necessario installarlo prima di usare runtest.

2. Abilita Driver Verifier per questo driver (i computer che eseguono Windows Vista o versioni successive non richiedono un riavvio).

3. Disabilita il driver usando l'applicazione Devcon.

4. Abilita il driver usando l'applicazione Devcon.

5. Recupera i nomi delle funzioni chiamate durante le operazioni di abilitazione e disabilitazione e identifica le funzioni che restituiscono NTSTATUS e che potrebbero non riuscire.

6. Avvia la notifica asincrona dell'evento WMI.

7. Per ogni DDI che potrebbe fallire dall'elenco ottenuto nel passaggio 5:

   1. Configura la funzione per il fallimento.
   2. Disabilita e quindi abilita il driver usando Devcon.exe. Questa operazione chiama la funzione e WdfTester fallisce la chiamata alla funzione.
   3. Attende che venga generato l'evento WMI.
   4. Se viene generato l'evento WMI, l'opzione runtest ripete il passaggio 7 per la funzione successiva nell'elenco.

8. Annulla la registrazione del conducente.