Creazione di un nuovo driver di funzione del dispositivo

In questo articolo viene illustrato come usare Visual Studio per iniziare a scrivere un nuovo driver di funzione del dispositivo. I driver di funzione del dispositivo sono diversi dai driver di filtro, dai driver software e dai driver di file system, illustrati in altri articoli. Per informazioni sui driver di funzione del dispositivo e su come differiscono da altri tipi di driver, vedere Che cos'è un driver?, Scelta di un modello di driver e Nodi dispositivo e Stack di dispositivi.

Per iniziare, determinare dove il dispositivo rientra nell'elenco delle tecnologie descritte in Tecnologie per dispositivi e driver. Per informazioni sui modelli di driver disponibili per il dispositivo, vedere la documentazione relativa a tale tecnologia specifica. Il modello di driver consigliato varia da una tecnologia all'altra. Per alcune tecnologie, la documentazione consiglia di usare User Mode Driver Framework (UMDF) o Kernel Mode Driver Framework (KMDF). Per altre tecnologie, la documentazione illustra come creare un minidriver che fa parte di una coppia di driver. I minidriver sono noti anche come miniport e miniclasse.

Determinare quali dei casi seguenti descrivono la raccomandazione del modello di driver e seguire questa procedura:

Caso 1: la documentazione per la tua tecnologia consiglia UMDF

1. Avvia Visual Studio.
2. Scegliere Crea un nuovo progetto nella finestra di dialogo di avvio oppure selezionare Nuovo | Progetto dal menu File di Visual Studio.
3. Nel riquadro destro della finestra di dialogo Crea un nuovo progetto individuare e selezionare Driver in modalità utente (UMDF V2).
4. Seleziona Avanti.
5. Compilare le caselle Nome progetto, Posizione e Nome soluzione e selezionare Crea. Per altre informazioni, vedere Scrittura di un driver UMDF basato su un modello.

   Annotazioni

   Quando si crea un nuovo driver UMDF, è necessario selezionare un nome di driver con almeno 32 caratteri. Questo limite di lunghezza è definito in wdfglobals.h.

6. A questo punto, è disponibile un progetto driver che implementa il codice generale richiesto dalla maggior parte dei driver UMDF. È ora possibile specificare il codice specifico del dispositivo. Per informazioni sulle interfacce da implementare, vedere la documentazione relativa alla tecnologia.

Caso 2: la documentazione della tua tecnologia consiglia KMDF

1. Avvia Visual Studio.
2. Scegliere Crea un nuovo progetto nella finestra di dialogo di avvio oppure selezionare Nuovo | Progetto dal menu File di Visual Studio.
3. Nel riquadro destro della finestra di dialogo Crea un nuovo progetto individuare e selezionare Driver in modalità kernel (KMDF).
4. Seleziona Avanti.
5. Compilare le caselle Nome progetto, Posizione e Nome soluzione e selezionare Crea. Per altre informazioni, vedere Scrittura di un driver KMDF basato su un modello.

   Annotazioni

   Quando si crea un nuovo driver KMDF, è necessario selezionare un nome di driver con 32 caratteri o meno. Questo limite di lunghezza è definito in wdfglobals.h.

6. A questo punto, è disponibile un progetto driver che implementa il codice generale richiesto dalla maggior parte dei driver KMDF. È ora possibile specificare il codice specifico del dispositivo. Per informazioni sui metodi da implementare, vedere la documentazione relativa alla tecnologia.

Caso 3: la documentazione della tua tecnologia descrive un modello di minidriver

Se la tecnologia del dispositivo ha un miniport, una miniclasse o un altro modello di minidriver, verificare se Visual Studio ha un modello specifico per il modello.

1. Avvia Visual Studio.
2. Scegliere Crea un nuovo progetto nella finestra di dialogo di avvio oppure selezionare Nuovo | Progetto dal menu File di Visual Studio.
3. Nel riquadro destro della finestra di dialogo Crea un nuovo progetto individuare l'elenco dei modelli installati per trovare un modello per il tipo di driver da scrivere.
4. Se trovi un modello per il tuo tipo di driver, selezionalo.
5. Seleziona Avanti.
6. Compilare le caselle Nome progetto, Posizione e Nome soluzione e selezionare Crea.
7. Se viene visualizzata una procedura guidata driver, eseguire la procedura guidata per creare il progetto driver.
8. A questo punto, si dispone di un progetto driver che implementa il codice generale richiesto dal driver. È ora possibile specificare il codice specifico del dispositivo. Per informazioni sulle funzioni da implementare, vedere la documentazione relativa alla tecnologia.

Se la tecnologia del tuo dispositivo utilizza un modello di minidriver e non riesci a trovare un modello specifico per il tuo tipo di minidriver, il modello di driver Windows (WDM) sarà probabilmente il tuo punto di partenza. Per indicazioni, vedere la documentazione specifica della tecnologia. In rari casi, è possibile usare KMDF per scrivere un minidriver, ma in genere il punto di partenza è WDM.

1. Avvia Visual Studio.
2. Scegliere Crea un nuovo progetto nella finestra di dialogo di avvio oppure selezionare Nuovo | Progetto dal menu File di Visual Studio.
3. Nel riquadro destro della finestra di dialogo Crea un nuovo progetto individuare e selezionare Driver WDM vuoto.
4. Seleziona Avanti.
5. Compilare le caselle Nome progetto, Posizione e Nome soluzione e selezionare Crea.
6. A questo punto, si dispone di un progetto di driver WDM vuoto. Nella finestra Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto driver e scegliere Aggiungi | Nuovo elemento.
7. Nella finestra di dialogo Aggiungi nuovo elemento immettere un nome per il file .cpp e selezionare Aggiungi.

   Annotazioni

   Se si vuole creare un file con estensione c invece di un file .cpp, immettere un nome con estensione c .

8. Per informazioni sulle funzioni da implementare, vedere la documentazione relativa alla tecnologia. Durante l'implementazione e l'organizzazione delle funzioni, è possibile decidere di aggiungere altri file .cpp o c.