Compilación de controladores IddCx 1.4
Debido a los cambios realizados en IddCx 1.3 para Windows 10 versión 1809, un controlador de pantalla indirecto (IDD) creado con IddCx v1.4 se puede ejecutar en Windows 10 versión 1809 mediante comprobaciones en tiempo de ejecución para comprobar si los cambios de DDI en IddCx 1.4 están disponibles en ese sistema. Consulte Building a WDF driver for multiple versions of Windows (Creación de un controlador WDF para varias versiones de Windows ) para obtener más información.
A partir de IddCx 1.4, se puede compilar un controlador IddCx para instalarlo en Windows 10, versión 1803 y posteriores haciendo lo siguiente. NOTA: Este controlador no se cargará en Windows 10, versiones 1607 a 1709.
- Compile y vincule el controlador mediante los encabezados y bibliotecas IddCx 1.4 del Kit de controladores de Windows (WDK).
- Establezca IDDCX_MINIMUM_VERSION_REQUIRED en 3 en el entorno de compilación. Esto indica al sistema operativo la versión mínima de IddCx para la que se compiló el controlador, 1.3 en este caso.
- Al inicializar estructuras IddCx, use la macro XXX_INIT correspondiente. Por ejemplo, use la macro IDD_CX_CLIENT_CONFIG_INIT() para inicializar una estructura de IDD_CX_CLIENT_CONFIG. La macro usa código en tiempo de ejecución para establecer el campo Tamaño en el tamaño correcto de la versión iddCx en la que se ejecuta el controlador.
- Use la macro IDD_IS_FIELD_AVAILABLE() para determinar si una estructura pasada al controlador de IddCx tiene definido ese campo. NOTA: IddCx 1.4 no extendió las estructuras existentes pasadas de IddCx al controlador, por lo que esta macro no necesita usarse en IddCx 1.4.
- Use la macro IDD_IS_FUNCTION_AVAILABLE() para determinar si una función IddCx determinada está disponible en el sistema operativo en el que se ejecuta el controlador. Por ejemplo, use IDD_IS_FUNCTION_AVAILABLE(IddCxAdapterSetRenderAdapter) para determinar si IddCxAdapterSetRenderAdapter() es compatible con este sistema operativo.
En la tabla siguiente se resumen las versiones de IddCx compatibles con diferentes versiones del sistema operativo.
| Versión del SO. | Versión de IddCx enviada con el sistema operativo | Versión iddCx de controladores que se pueden ejecutar |
|---|---|---|
| 1607 (RS1) | 1.0 | 1.0 |
| 1703 (RS2) | 1.0 | 1.0 |
| 1709 (RS3) | 1.2 | 1.0 y 1.2 |
| 1803 (RS4) | 1.3 | 1.0-1.3 y 1.4 anteriores(*) |
| 1809 (RS5) | 1.3 | 1.0-1.3 y 1.4 anteriores(*) |
| 1903 (19H1) | 1.4 | 1.0-1.3 y 1.4 anteriores(*) |
| 1909 (19H2) | 1.4 | 1.0-1.3 y 1.4 anteriores(*) |
| 2004 (20H1) | 1.4 | 1.0-1.3 y 1.4 anteriores(*) |
| N/D | 1.6 | 1.0-1.3 y 1.4 anteriores(*) |
* Un IddCx 1.4 y versiones posteriores de IDD debe usar las macros dinámicas, como IDD_IS_FUNCTION_AVAILABLE() para decidir en tiempo de ejecución a qué funcionalidad del sistema operativo puede llamar. Estas macros dinámicas se definen en iddcx.h.
Para admitir todas las versiones posibles de Windows:
- Escriba un controlador IddCx 1.0 para Windows 10, versiones 1607 a 1709.
- Escriba un único controlador IddCx 1.4 o posterior para Windows 10, versión 1803 y posteriores.