Nicht-virtualisierte GPUs

Last published : Nov 13, 2026
In der Linux-VDA-Dokumentation beziehen sich nicht-virtualisierte GPUs auf:
  • GPUs, die in Remote-PC-Zugriffsszenarien verwendet werden
  • GPUs, die von einem Hypervisor durchgereicht werden
Dieser Artikel enthält Informationen zur Unterstützung nicht-virtualisierter GPUs.
Related information
Grafik

HDX™ 3D Pro für NVIDIA-GPUs aktivieren, die das NVIDIA Capture SDK für Linux unterstützen

Für NVIDIA-GPUs, die das NVIDIA Capture SDK für Linux unterstützen, aktivieren Sie HDX 3D Pro einfach, indem Sie bei der Installation des Linux VDA CTX_XDL_HDX_3D_PRO auf Y setzen. Es ist keine zusätzliche Konfiguration erforderlich. Die Hardwarebeschleunigung ist standardmäßig aktiviert, nachdem Sie HDX 3D Pro aktiviert haben.

Kompatibel mit NVIDIA-GPUs, die das NVIDIA Capture SDK für Linux nicht unterstützen, und GPUs anderer Hersteller wie AMD und Intel

Hinweis:
In diesem Szenario wird nur Software-Kodierung unterstützt.

Schritt 1: CTX_XDL_HDX_3D_PRO bei der Installation des Linux VDA auf Y setzen

Informationen zu Umgebungsvariablen finden Sie unter Schritt 8: Einrichten der Laufzeitumgebung zur Durchführung der Installation.

Schritt 2: Xdamage installieren

Sie können beispielsweise sudo apt-get install -y libxdamage1 ausführen, um XDamage unter Ubuntu 20.04 zu installieren. Typischerweise existiert XDamage als Erweiterung von XServer.

Schritt 3: XDamage durch Ausführen des folgenden Befehls aktivieren

/opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_DWORD" -v "XDamageEnabled" -d "0x00000001" --force

Schritt 4: Xorg-Konfigurationsdateien ändern

Die folgenden vier Vorlagen-Konfigurationsdateien finden Sie unter /etc/X11. Je nach Anzahl der angeschlossenen Monitore ändern Sie eine der Vorlagen-Konfigurationsdateien mit der entsprechenden Nummer im Namen. Wenn beispielsweise nur ein Monitor angeschlossen ist, ändern Sie die Vorlagen-Konfigurationsdatei mit der Nummer 1 im Namen, d. h. ctx-driver_name-1.conf. Wenn zwei Monitore angeschlossen sind, ändern Sie die Vorlagen-Konfigurationsdatei mit der Nummer 2 im Namen, d. h. ctx-driver_name-2.conf.
  • ctx-driver\_name-1.conf
  • ctx-driver\_name-2.conf
  • ctx-driver\_name-3.conf
  • ctx-driver\_name-4.conf
Am Beispiel von ctx-driver\_name-1.conf gehen Sie wie folgt vor, um die Vorlagen-Konfigurationsdateien zu ändern:
  1. Ersetzen Sie driver\_name durch Ihren tatsächlichen Treibernamen.
    Wenn Ihr Treibername beispielsweise intel lautet, können Sie den Namen der Konfigurationsdatei in ctx-intel-1.conf ändern.
  2. Fügen Sie die Informationen zum Videotreiber hinzu.
    Jede Vorlagen-Konfigurationsdatei enthält einen auskommentierten Abschnitt namens „Device“. Dieser Abschnitt beschreibt die Informationen zum Videotreiber. Aktivieren Sie diesen Abschnitt, bevor Sie Ihre Videotreiberinformationen hinzufügen. So aktivieren Sie diesen Abschnitt:
    1. Informationen zur Konfiguration finden Sie im Handbuch des GPU-Herstellers. Eine native Konfigurationsdatei kann generiert werden. Stellen Sie sicher, dass Ihre GPU in einer lokalen Umgebung mit der nativen Konfigurationsdatei funktioniert.
    2. Kopieren Sie den Abschnitt „Device“ der nativen Konfigurationsdatei in ctx-driver\_name-1.conf.
  3. Führen Sie den folgenden Befehl aus, um den Registrierungsschlüssel festzulegen, damit der Linux VDA den in Schritt 1 festgelegten Namen der Konfigurationsdatei erkennen kann.
    /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_SZ" -v "DriverName" -d "intel" --force

Monitor-Blanking für Remote-PC-Zugriff-VDAs

Der Linux VDA unterstützt physisches Monitor-Blanking für Remote-PC-Zugriff-VDAs, die nicht-virtualisierte GPUs verwenden.
Vollständig getestete Linux-Distributionen, die die Funktion unterstützen, sind Ubuntu 20.04 und Debian 11.
Die Funktion ist standardmäßig deaktiviert. Um sie zu aktivieren, führen Sie die folgenden zwei Schritte aus:
  1. Installieren Sie das evdi-dkms-Paket basierend auf Ihrer Linux-Distribution:
    sudo apt install evdi-dkms
  2. Grafikanzeige-Offloading auf EVDI aktivieren:
    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "Evdi" -d "0x00000001" --force
  3. Wenn Sie eine Intel-GPU verwenden, deaktivieren Sie den Display-Manager. Andernfalls belegt der Display-Manager die Intel-GPU und macht sie für Citrix®-Remotesitzungen unbrauchbar.
    sudo systemctl disable --now gdm

Problembehandlung

Keine oder fehlerhafte Grafikausgabe

Wenn Sie 3D-Anwendungen lokal ausführen können und alle Konfigurationen korrekt sind, ist eine fehlende oder fehlerhafte Grafikausgabe das Ergebnis eines Fehlers. Verwenden Sie /opt/Citrix/VDA/bin/setlog und setzen Sie GFX\_X11 auf verbose, um die Trace-Informationen für das Debugging zu sammeln.