Panoramica dello sviluppo di driver Windows per i controller di funzione USB

2025-04-03

Questo articolo descrive il supporto nel sistema operativo Windows per lo sviluppo di un driver di controller di funzione USB (Universal Serial Bus) che comunica con l'estensione UFX (Usb Function Controller) fornita da Microsoft.

Strumenti di sviluppo e file binari forniti da Microsoft

Windows Driver Kit (WDK) contiene risorse necessarie per lo sviluppo di driver, ad esempio intestazioni, librerie, strumenti ed esempi.

Scaricare kit e strumenti per Windows

Windows fornisce driver del controller di funzione USB inclusi, come UfxSynopsys.sys per il controller hardware di Synopsys IP. In genere richiedono modifiche e convalida a livello di piattaforma che vengono in genere eseguite da partner hardware o OEM quando si attiva una piattaforma. Questo processo di attivazione può includere l'integrazione con ACPI per notificare ai driver di sistema eventi di collegamento/scollegamento USB ed eseguire una convalida aggiuntiva usando test HLK forniti da Microsoft. Per scrivere un driver controller personalizzato, è necessario:

UFX (Ufx01000.sys) caricato come FDO. Questo driver è incluso in Windows.
Collegamento alla libreria stub (Ufx01000.lib). La libreria stub si trova nel WDK (Windows Driver Kit). La libreria converte le chiamate effettuate dal driver del controller di funzione e le passa a UFX.
Includere Ufxclient.h fornito nel WDK.

Per inviare richieste dalla modalità utente, è necessario:

GenericUSBFn.sys caricato come driver della classe di funzione USB. Questo driver è incluso in Windows.
Includere Genericusbfnioctl.h fornito nel WDK.

Per inviare richieste dal driver di classe USB, è necessario:

UFX (Ufx01000.sys) caricato come FDO. Questo driver è incluso in Windows.
Includere Usbfnioctl.h fornito nel WDK.

Per scrivere un driver di filtro che gestisce la ricarica tramite caricabatterie proprietari, è necessario:

UfxChipidea.sys o Ufxsynopsys.sys sono stati caricati in qualità di driver client in UFX.
Includi Ufxproprietarycharger.h fornito nel WDK.

Architettura di UFX

Acquisire familiarità con lo stack di driver USB fornito da Microsoft:

Driver del lato dispositivo USB in Windows

Acquisisci familiarità con gli oggetti e gli handle UFX

UFX estende la funzionalità dell'oggetto WDF per definire i propri oggetti UCX specifici di USB. Per altri dettagli sugli oggetti WDF, vedere Introduzione agli oggetti Framework.

Per le richieste di accodamento, UFX usa oggetti specifici per USB. Per ulteriori informazioni, vedere gli oggetti UFX e gli handle usati da un driver client di funzioni USB.