Erstellen von IddCx 1.4-Treibern
Aufgrund von Änderungen, die in IddCx 1.3 für Windows 10 Version 1809 vorgenommen wurden, kann ein für IddCx v1.4 erstellter indirekter Anzeigetreiber (IDD) unter Windows 10 Version 1809 ausgeführt werden, indem Laufzeitüberprüfungen verwendet werden, um zu überprüfen, ob DDI-Änderungen in IddCx 1.4 auf diesem System verfügbar sind. Weitere Informationen finden Sie unter Erstellen eines WDF-Treibers für mehrere Versionen von Windows .
Ab IddCx 1.4 kann ein IddCx-Treiber für die Installation unter Windows 10, Version 1803 und höher, wie folgt erstellt werden. HINWEIS: Dieser Treiber wird nicht auf Windows 10 der Versionen 1607 bis 1709 geladen.
- Erstellen und verknüpfen Sie den Treiber mithilfe der IddCx 1.4-Header und -Bibliotheken aus dem Windows Driver Kit (WDK).
- Legen Sie IDDCX_MINIMUM_VERSION_REQUIRED in der Buildumgebung auf 3 fest. Dadurch wird dem Betriebssystem die IddCx-Mindestversion mitgeteilt, für die der Treiber erstellt wurde, in diesem Fall 1.3.
- Verwenden Sie beim Initialisieren von IddCx-Strukturen das entsprechende XXX_INIT-Makro. Verwenden Sie beispielsweise das Makro IDD_CX_CLIENT_CONFIG_INIT(), um eine IDD_CX_CLIENT_CONFIG-Struktur zu initialisieren. Das Makro verwendet Laufzeitcode, um das Feld Größe auf die richtige Größe für die IddCx-Version festzulegen, unter der der Treiber ausgeführt wird.
- Verwenden Sie das Makro IDD_IS_FIELD_AVAILABLE(), um zu bestimmen, ob für eine struktur, die von IddCx an den Treiber übergeben wird, dieses Feld definiert ist. HINWEIS: IddCx 1.4 hat keine vorhandenen Strukturen erweitert, die von IddCx an den Treiber übergeben wurden, sodass dieses Makro nicht in IddCx 1.4 verwendet werden muss.
- Verwenden Sie das Makro IDD_IS_FUNCTION_AVAILABLE(), um zu bestimmen, ob eine bestimmte IddCx-Funktion auf dem Betriebssystem verfügbar ist, unter dem der Treiber ausgeführt wird. Verwenden Sie beispielsweise IDD_IS_FUNCTION_AVAILABLE(IddCxAdapterSetRenderAdapter), um zu ermitteln, ob IddCxAdapterSetRenderAdapter() unter diesem Betriebssystem unterstützt wird.
In der folgenden Tabelle sind die IddCx-Versionen zusammengefasst, die von verschiedenen Betriebssystemversionen unterstützt werden.
| Betriebssystemversion | IddCx-Version im Lieferumfang des Betriebssystems | IddCx-Version von Treibern, die ausgeführt werden können |
|---|---|---|
| 1607 (RS1) | 1.0 | 1.0 |
| 1703 (RS2) | 1.0 | 1.0 |
| 1709 (RS3) | 1.2 | 1.0 und 1.2 |
| 1803 (RS4) | 1.3 | 1.0-1.3 und 1.4 oben(*) |
| 1809 (RS5) | 1.3 | 1.0-1.3 und 1.4 oben(*) |
| 1903 (19H1) | 1.4 | 1.0-1.3 und 1.4 oben(*) |
| 1909 (19H2) | 1.4 | 1.0-1.3 und 1.4 oben(*) |
| 2004 (20H1) | 1.4 | 1.0-1.3 und 1.4 oben(*) |
| – | 1.6 | 1.0-1.3 und 1.4 oben(*) |
* Eine IddCx 1.4 und höher muss die dynamischen Makros wie IDD_IS_FUNCTION_AVAILABLE() verwenden, um zur Laufzeit zu entscheiden, welche Betriebssystemfunktionen aufgerufen werden können. Diese dynamischen Makros sind in iddcx.h definiert.
So unterstützen Sie alle möglichen Versionen von Windows:
- Schreiben Sie einen IddCx 1.0-Treiber für Windows 10, Versionen 1607 bis 1709.
- Schreiben Sie einen einzelnen IddCx 1.4- oder höher-Treiber für Windows 10, Version 1803 und höher.