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-Encoding unterstützt.

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

Informationen zu Umgebungsvariablen finden Sie unter Schritt 8: Laufzeitumgebung für die Installation einrichten.

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

Sie finden die folgenden vier Vorlagenkonfigurationsdateien unter /etc/X11. Basierend auf der Anzahl der angeschlossenen Monitore ändern Sie eine der Vorlagenkonfigurationsdateien mit der entsprechenden Nummer im Namen. Wenn beispielsweise nur ein Monitor angeschlossen ist, ändern Sie die Vorlagenkonfigurationsdatei mit der Nummer 1 im Namen, d. h. ctx-driver_name-1.conf. Wenn zwei Monitore angeschlossen sind, ändern Sie die Vorlagenkonfigurationsdatei 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
Verwenden Sie ctx-driver\_name-1.conf als Beispiel und führen Sie die folgenden Schritte aus, um die Vorlagenkonfigurationsdateien 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 Vorlagenkonfigurationsdatei enthält einen Abschnitt namens „Device“, der auskommentiert ist. 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. Überprüfen Sie, ob Ihre GPU in einer lokalen Umgebung mit der nativen Konfigurationsdatei funktioniert.
    2. Kopieren Sie den Abschnitt „Device“ der nativen Konfigurationsdatei nach ctx-driver\_name-1.conf.
  3. Führen Sie den folgenden Befehl aus, um den Registrierungsschlüssel so festzulegen, dass 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

Monitorabschaltung für Remote-PC-Zugriff-VDAs

Der Linux VDA unterstützt die physische Monitorabschaltung 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. Aktivieren Sie die Auslagerung der Grafikanzeige auf EVDI:
    /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.