Principi e procedure consigliate per la progettazione DCH

Questo articolo descrive i principi di progettazione e le procedure consigliate per i pacchetti driver conformi a DCH. DCH è l'acronimo di Declarative (D), Componentized (C) e Hardware Support App (H).

Principi di progettazione DCH

Esistono tre principi di progettazione da considerare affinché un pacchetto driver sia conforme a DCH:

• Dichiarativo: installare il pacchetto driver usando solo le direttive INF dichiarative. Non includere coinstallatori o funzioni RegisterDll.

• Componentizzato: le personalizzazioni specifiche dell'edizione, specifiche dell'OEM e facoltative per il pacchetto driver sono separate dal pacchetto driver di base. Di conseguenza, il pacchetto driver di base, che fornisce solo le funzionalità principali del dispositivo, può essere destinato, testato in fase di volo e fornito in modo indipendente dalle personalizzazioni.

• App HSA (Hardware Support App): qualsiasi componente dell'interfaccia utente associato a un pacchetto driver deve essere inserito in un pacchetto HSA o preinstallato nel dispositivo OEM. Un'app HSA è un'app specifica del dispositivo facoltativa abbinata a un pacchetto driver. L'applicazione può essere un'app UWP (Universal Windows Platform) o Desktop Bridge compilata con un pacchetto MSIX a partire dal tuo codice. È necessario distribuire e aggiornare un modulo di protezione hardware tramite Microsoft Store. Per altre informazioni, vedere HSA: Passaggi per sviluppatori di driver e HSA: Passaggi per sviluppatori di app.

Per informazioni su come un esempio di driver può applicare principi di progettazione DCH, vedere Esempio di pacchetto driver conforme a DCH.

Panoramica di DCH

I pacchetti driver conformi a DCH contengono un file INF e file binari che installano ed eseguono nelle edizioni basate su UWP di Windows. Installano ed eseguono anche in altre edizioni di Windows 10 e 11 che condividono un set comune di interfacce.

I file binari del driver conformi a DCH possono usare Kernel-Mode Driver Framework (KMDF), User-Mode Driver Framework 2 (UMDF) o Windows Driver Model (WDM).

I pacchetti driver conformi a DCH sono costituiti dalle parti seguenti:

• Un pacchetto driver di base
• Pacchetti di componenti facoltativi
• Un'app di supporto hardware facoltativa

Il pacchetto driver di base contiene tutte le funzionalità di base e il codice condiviso. I pacchetti di componenti facoltativi possono contenere personalizzazioni e altre impostazioni.

In genere, un produttore di dispositivi o un fornitore di hardware indipendente (IHV), scrive il pacchetto del driver di base. Quindi, un generatore di sistema o un produttore di apparecchiature originali (OEM), fornisce eventuali pacchetti di componenti facoltativi.

Dopo che un IHV certifica il pacchetto driver di base, può essere distribuito in tutti i sistemi OEM. Poiché un pacchetto driver di base può essere usato in tutti i sistemi che condividono una parte hardware, Microsoft può testare il pacchetto driver di base su larga scala. Microsoft può usare windows Insider flighting, invece di limitare la distribuzione a computer specifici.

L'OEM convalida solo le personalizzazioni facoltative fornite per il sistema OEM.

Requisiti DCH

Per creare un pacchetto driver che segue i principi di progettazione DCH, seguire questa procedura:

1. Creare un file INF per il pacchetto driver:

   1. Esaminare l'elenco delle sezioni e delle direttive INF valide nei pacchetti driver universali.

   2. Usare lo strumento InfVerif per verificare che il file INF del pacchetto driver segua i requisiti dichiarativi (D). Il pacchetto deve passare il controllo con il comando infverif /k.

2. Assicurarsi che tutti i pacchetti di componenti facoltativi che non contengono funzionalità del driver di base siano separati dal pacchetto driver di base.

3. Le app di supporto hardware associate al pacchetto driver devono essere distribuite tramite Microsoft Store.

Procedure consigliate per DCH

Quando si sviluppa per garantire la conformità DCH, seguire queste procedure consigliate.

• Se usi il Windows Driver Kit (WDK) con l'ultima versione di Visual Studio, imposta il valore della Piattaforma di Destinazione nelle proprietà del progetto driver su Universal. Questa impostazione aggiunge automaticamente le librerie corrette ed esegue la convalida INF corretta e ApiValidator come parte della compilazione. Per completare questa attività, effettuare i seguenti passaggi:

  1. Aprire le proprietà del progetto driver.
  2. Selezionare Impostazioni driver.
  3. Usare il menu a discesa per impostare il valore della piattaforma di destinazione su Universal.

• Se in INF vengono eseguite azioni di configurazione personalizzate che dipendono dalla piattaforma di destinazione, è consigliabile separare le azioni in un'estensione INF. È possibile aggiornare un'estensione INF indipendentemente dal pacchetto driver di base per renderla più affidabile e gestibile. Per altre informazioni, vedere Uso di un file INF di estensione.

• Se si vuole fornire un'applicazione che funziona con il dispositivo, includere un modulo di protezione hardware. Per altre informazioni, vedere HSA: Passaggi per sviluppatori di driver. Un OEM può precaricare un'app HSA usando Deployment Image Servicing and Management (DISM) oppure, gli utenti possono scaricare manualmente l'app da Microsoft Store.