Génération de pilotes IddCx 1.4

En raison des modifications apportées dans IddCx 1.3 pour Windows 10 version 1809, un pilote d’affichage indirect (IDD) créé sur IddCx v1.4 peut s’exécuter sur Windows 10 version 1809 à l’aide de vérifications du runtime pour vérifier si les modifications DDI dans IddCx 1.4 sont disponibles sur ce système. Pour plus d’informations, consultez Génération d’un pilote WDF pour plusieurs versions de Windows .

À compter d’IddCx 1.4, vous pouvez créer un pilote IddCx pour l’installer sur Windows 10, version 1803 et ultérieure en procédant comme suit. REMARQUE : ce pilote ne se charge pas sur Windows 10, versions 1607 à 1709.

• Générez et liez le pilote à l’aide des en-têtes et bibliothèques IddCx 1.4 à partir du Kit de pilotes Windows (WDK).
• Définissez IDDCX_MINIMUM_VERSION_REQUIRED sur 3 dans l’environnement de génération. Cela indique au système d’exploitation la version minimale d’IddCx pour laquelle le pilote a été créé, 1.3 dans ce cas.
• Lors de l’initialisation des structures IddCx, utilisez la macro XXX_INIT correspondante. Par exemple, utilisez la macro IDD_CX_CLIENT_CONFIG_INIT() pour initialiser une structure IDD_CX_CLIENT_CONFIG. La macro utilise le code d’exécution pour définir le champ Taille sur la taille correcte pour la version IddCx sur laquelle le pilote s’exécute.
• Utilisez la macro IDD_IS_FIELD_AVAILABLE() pour déterminer si ce champ est défini pour une structure passée au pilote à partir d’IddCx. REMARQUE : IddCx 1.4 n’a pas étendu les structures existantes passées d’IddCx au pilote. Cette macro n’a donc pas besoin d’être utilisée dans IddCx 1.4.
• Utilisez la macro IDD_IS_FUNCTION_AVAILABLE() pour déterminer si une fonction IddCx donnée est disponible sur le système d’exploitation sur lequel le pilote s’exécute. Par exemple, utilisez IDD_IS_FUNCTION_AVAILABLE(IddCxAdapterSetRenderAdapter) pour déterminer si IddCxAdapterSetRenderAdapter() est pris en charge sur ce système d’exploitation.

Le tableau suivant récapitule les versions d’IddCx prises en charge par différentes versions du système d’exploitation.

Version du SE	Version d’IddCx fournie avec le système d’exploitation	Version IddCx des pilotes qui peuvent s’exécuter
1607 (RS1)	1.0	1.0
1703 (RS2)	1.0	1.0
1709 (RS3)	1,2	1.0 et 1.2
1803 (RS4)	1.3	1.0-1.3 et 1.4 ci-dessus(*)
1809 (RS5)	1.3	1.0-1.3 et 1.4 ci-dessus(*)
1903 (19H1)	1.4	1.0-1.3 et 1.4 ci-dessus(*)
1909 (19H2)	1.4	1.0-1.3 et 1.4 ci-dessus(*)
2004 (20H1)	1.4	1.0-1.3 et 1.4 ci-dessus(*)
N/A	1.6	1.0-1.3 et 1.4 ci-dessus(*)

* Un IDD IddCx 1.4 et versions ultérieures doit utiliser les macros dynamiques telles que IDD_IS_FUNCTION_AVAILABLE() afin de décider au moment de l’exécution des fonctionnalités du système d’exploitation qu’il peut appeler. Ces macros dynamiques sont définies dans iddcx.h.

Pour prendre en charge toutes les versions possibles de Windows :

• Écrivez un pilote IddCx 1.0 pour Windows 10, versions 1607 à 1709.
• Écrivez un seul pilote IddCx 1.4 ou ultérieur pour Windows 10, version 1803 et ultérieure.