Approvazione del file Sdv-map.h

Il file Sdv-map.h include una riga di testo che indica all'SDV che il file è stato approvato, presumibilmente dopo aver esaminato il file e corretto eventuali errori. Al momento della creazione, il file Sdv-map.h include la frase "Approved=false".

Per approvare un file Sdv-map.h

1. Aprire il file Sdv-map.h in un editor di testo, ad esempio Blocco note. SDV crea il file Sdv-map.h nella directory sources del driver. Si tratta della directory locale per una verifica.

2. Impostare Approved=false su Approved=true.

Quando è necessario approvare un file Sdv-map.h

Sdv-map.h è corretto e completo quando SDV è attivo:

• Trovati tutti i punti di ingresso che utilizza.

• Ha associato i punti di ingresso ai tipi di ruolo della funzione corretti.

Quando è necessario correggere un file Sdv-map.h

Il file Sdv-map.h non è corretto o incompleto quando SDV:

• Non è stato rilevato alcun punto di ingresso nel driver, in genere perché non è in grado di trovare dichiarazioni di tipo di ruolo della funzione (vedere Uso delle dichiarazioni del tipo di ruolo funzione).

• Dispone di funzioni di callback duplicate associate a un tipo di ruolo di funzione.

• Ha più funzioni di callback rispetto al massimo supportato per un tipo di ruolo di funzione.

• È stato rilevato che nel file Sdv-map.h sono presenti nomi di funzione errati o non esistenti dopo l'approvazione del file.

Non è necessario che i driver abbiano ogni punto di ingresso che SDV può analizzare. Se la verifica di una determinata regola richiede un punto di ingresso del driver di cui il driver non dispone, SDV annulla la verifica di tale regola e restituisce un risultato Non Applicabile. Questo risultato non è considerato un risultato negativo.

Se SDV non riesce a trovare punti di ingresso nel driver, procede comunque con l'analisi. Se il file di intestazione usato nell'analisi è incompleto o errato, i risultati della verifica non sono affidabili.

Se, dopo l'approvazione del file, SDV rileva che nel file Sdv-map.h sono presenti nomi di funzione errati o non esistenti, SDV esce e genera un messaggio di avviso simile all'esempio seguente.

Warning 'driver' It appears that your sdv-map.h file has an incorrect entry at this line "#define fun_IRP_MJ_PNP DispatchPnpNotExist". Please regenerate your sdv-map.h file.

Per correggere questo errore, eliminare le righe nel file Sdv.map che causano l'errore o rigenerano il file.

Per rigenerare il file Sdv-map.h

1. Aprire il file Sdv-map.h e modificare Approved=true in Approved=false.

2. Usare il comando staticdv /scan per rigenerare il file di mappa oppure usare un comando staticdv /rule o staticdv /config per eseguire un'analisi SDV.