Approvazione del file Sdv-map.h

Articolo
06/14/2023

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

Per approvare un file Sdv-map.h

Aprire il file Sdv-map.h in un editor di testo, ad esempio Blocco note. SDV crea il file Sdv-map.h nella directory delle origini del driver. È la directory locale per una verifica.
Modificare //Approved=false in //Approved=true.

Quando è necessario approvare un file Sdv-map.h

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

Trovato tutti i punti di ingresso usati.
I punti di ingresso sono associati ai tipi di ruolo delle funzioni 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 funzione (vedere Uso delle dichiarazioni del tipo di ruolo funzione).
Dispone di funzioni di callback duplicate associate a un tipo di ruolo di funzione.
Dispone di 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 funzioni non corretti o non esistenti dopo l'approvazione del file.

I driver non sono necessari per avere ogni punto di ingresso che SDV può analizzare. Se la verifica di una determinata regola richiede un punto di ingresso del driver che il driver non ha, SDV annulla la verifica di tale regola e restituisce un risultato non applicabile. Questo risultato non viene considerato un risultato negativo.

A meno che SDV non possa trovare punti di ingresso nel driver, procede con la relativa analisi. Se il file di intestazione usato nell'analisi è incompleto o non corretto, i risultati della verifica non sono affidabili.

Se SDV rileva che sono presenti nomi di funzioni non esistenti o non esistenti nel file Sdv-map.h dopo l'approvazione del file, SDV chiude e genera un messaggio di avviso come l'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

Aprire il file Sdv-map.h e modificare //Approved=true in //Approved=false.
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.