Compilazione di driver IddCx 1.4
A causa delle modifiche apportate in IddCx 1.3 per Windows 10 versione 1809, un driver di visualizzazione indiretto (IDD) compilato in IddCx v1.4 può essere eseguito in Windows 10 versione 1809 usando i controlli di runtime per verificare se le modifiche DDI in IddCx 1.4 sono disponibili in tale sistema. Per altre informazioni, vedere Compilazione di un driver WDF per più versioni di Windows .
A partire da IddCx 1.4, è possibile compilare un driver IddCx per l'installazione in Windows 10, versione 1803 e successive eseguendo le operazioni seguenti. NOTA: questo driver non verrà caricato in Windows 10, versioni da 1607 a 1709.
- Compilare e collegare il driver usando le intestazioni e le librerie IddCx 1.4 da Windows Driver Kit (WDK).
- Impostare IDDCX_MINIMUM_VERSION_REQUIRED su 3 nell'ambiente di compilazione. Questo indica al sistema operativo la versione minima iddCx per cui è stato compilato il driver, 1.3 in questo caso.
- Quando si inizializzano le strutture IddCx, utilizzare la macro XXX_INIT corrispondente. Ad esempio, utilizzare la macro IDD_CX_CLIENT_CONFIG_INIT() per inizializzare una struttura IDD_CX_CLIENT_CONFIG. La macro usa il codice di runtime per impostare il campo Dimensioni sulle dimensioni corrette per la versione IddCx in cui è in esecuzione il driver.
- Utilizzare la macro IDD_IS_FIELD_AVAILABLE() per determinare se una struttura passata al driver da IddCx dispone di tale campo definito. NOTA: IddCx 1.4 non ha esteso le strutture esistenti passate da IddCx al driver, pertanto questa macro non deve essere usata in IddCx 1.4.
- Usare la macro IDD_IS_FUNCTION_AVAILABLE() per determinare se una determinata funzione IddCx è disponibile nel sistema operativo in cui è in esecuzione il driver. Ad esempio, usare IDD_IS_FUNCTION_AVAILABLE(IddCxAdapterSetRenderAdapter) per determinare se IddCxAdapterSetRenderAdapter() è supportato in questo sistema operativo.
La tabella seguente riepiloga le versioni IddCx supportate da versioni diverse del sistema operativo.
| Versione sistema operativo | Versione iddCx fornita con il sistema operativo | Versione iddCx dei driver che possono essere eseguiti |
|---|---|---|
| 1607 (RS1) | 1.0 | 1.0 |
| 1703 (RS2) | 1.0 | 1.0 |
| 1709 (RS3) | 1,2 | 1.0 e 1.2 |
| 1803 (RS4) | 1.3 | 1.0-1.3 e 1.4 sopra(*) |
| 1809 (RS5) | 1.3 | 1.0-1.3 e 1.4 sopra(*) |
| 1903 (19H1) | 1.4 | 1.0-1.3 e 1.4 sopra(*) |
| 1909 (19H2) | 1.4 | 1.0-1.3 e 1.4 sopra(*) |
| 2004 (20H1) | 1.4 | 1.0-1.3 e 1.4 sopra(*) |
| N/D | 1.6 | 1.0-1.3 e 1.4 sopra(*) |
* Un IDdCx 1.4 e un IDD superiore devono usare le macro dinamiche, ad esempio IDD_IS_FUNCTION_AVAILABLE() per decidere in fase di esecuzione quale funzionalità del sistema operativo può chiamare. Queste macro dinamiche sono definite in iddcx.h.
Per supportare tutte le possibili versioni di Windows:
- Scrivere un driver IddCx 1.0 per Windows 10, versioni da 1607 a 1709.
- Scrivere un singolo driver IddCx 1.4 o versione successiva per Windows 10, versione 1803 e successive.