Importieren von Funktionen aus einer DLL

Mit Hilfe des DLL-Importassistenten können Sie eine LabVIEW-Projektbibliotheksdatei aus Wrapper-VIs für Funktionen erzeugen oder bearbeiten. Die Funktionen der Wrapper-VIs können in Form einer *.dll-Datei (Windows), *.so-Datei (Linux) oder *.framework-Datei (macOS) vorliegen. Sie müssen den Namen einer DLL und einer Header-Datei (*.h) zur Analyse im Assistenten angeben. Der DLL-Importassistent unterstützt nur Header-Dateien, die mit der Syntax von C/C++ kompatibel sind und die C-Aufrufkonvention oder die standardmäßige Aufrufkonvention (_stdcall) verwenden.

Nachfolgend wird beschrieben, wie Wrapper-VIs für Funktionen in einer DLL erzeugt und geändert werden:

1. Wählen Sie Werkzeuge»Importieren»DLL, um zum DLL-Importassistenten zu gelangen. Die Seite Erstellungs- oder Aktualisierungsmodus angeben wird angezeigt.
2. Wenn Sie Wrapper-VIs für eine DLL erstellen möchten, die vorher nicht importiert wurde, wählen Sie VIs für DLL erstellen. Wenn Sie Wrapper-VIs für eine DLL aktualisieren möchten, die zuvor importiert wurde, wählen Sie VIs für DLL ändern und wählen Sie dann eine Bibliothek aus der Liste.

1. Klicken Sie auf Weiter, um zur Seite DLL- und Header-Datei wählen des Assistenten zu gelangen.
2. Geben Sie den Pfad zu der DLL, die importiert werden soll, in das Textfeld Bibliothek (*.dll) ein oder klicken Sie auf Durchsuchen zur Auswahl der Datei.
3. Wenn Sie VIs für eine DLL erstellen möchten, die sich nicht auf dem lokalen Rechner befindet (z. B. wenn sich die DLL auf einem RT-Zielsystem befindet), aktivieren Sie die Option DLL befindet sich nicht auf lokalem Computer und geben Sie den Namen der DLL in das Textfeld DLL ein. Der Pfad zur DLL muss nicht eingegeben werden.

Hinweis Wenn nur ein Dateiname und kein Pfad angegeben wird, muss sich die DLL im Zielverzeichnis für die Wrapper-VIs befinden oder sie muss über den Suchpfad des Systems verfügbar sein.

1. Geben Sie den Pfad zu der Header-Datei, die mit der DLL verwendet werden soll, in das Textfeld Header-Datei (.h) ein oder klicken Sie auf Durchsuchen zur Auswahl der Datei. Der DLL-Importassistent unterstützt nur Header-Dateien, die mit der Syntax von C/C++ kompatibel sind und die C- oder Standardaufrufkonvention (WINAPI) verwenden.
2. Klicken Sie auf Weiter zur Anzeige der Seite Einzuschließende Pfade und Präprozessor-Definitionen konfigurieren und geben Sie alle einzuschließenden Pfade und Präprozessor-Definitionen ein, die bei der Analyse der Header-Datei verwendet werden sollen.
3. Klicken Sie anschließend auf Weiter, um zur Seite Zu konvertierende Funktionen auswählen zu gelangen. Es wird ein Dialogfeld angezeigt, in dem mitgeteilt wird, dass LabVIEW die Header-Datei analysiert.
4. Auf der Seite Zu konvertierende Funktionen auswählen werden alle in der DLL gefundenen Funktionen angezeigt. Wenn eine Funktion nicht importiert werden kann, wird sie in der Liste mit einem schwarzen gekennzeichnet. Beim Markieren der Funktion werden mögliche Ursachen für den Fehler aufgeführt.

Hinweis Wenn Sie die Option DLL befindet sich nicht auf lokalem Computer ausgewählt haben, werden nur die Funktionen aufgelistet, die in der Header-Datei angegeben sind. Andernfalls werden auf dieser Seite auch Funktionen aufgelistet, die von der DLL aufgerufen werden, die nicht in der Header-Datei festgelegt wurden.

1. (Optional) Wenn Funktionen nicht importiert werden können, klicken Sie auf Zurück, um vorhandene einzubeziehende Pfade und Präprozessor-Definitionen hinzuzufügen, zu entfernen oder zu aktualisieren. Bei erheblichen Fehlern sollten Sie den Vorgang möglicherweise abbrechen und jede Header-Datei einzeln bearbeiten. So gehen Sie sicher, dass die Datei in Ordnung ist, bevor Sie mit dem DLL-Importassistenten Wrapper-VIs erstellen.
2. Wählen Sie auf der Seite Zu konvertierende Funktionen auswählen die Funktionen, die konvertiert werden sollen, indem Sie ein Häkchen neben die entsprechende Funktion setzen. Klicken Sie auf die Schaltfläche Auswahl aufheben, wenn Sie Wrapper-VIs für alle Funktionen in der Liste erstellen möchten.
3. Klicken Sie auf Weiter, um zur Seite Einstellungen der Projektbibliothek konfigurieren zu gelangen.
4. Geben Sie einen Namen für die zu erstellende Projektbibliotheksdatei im Textfeld Projektbibliotheksname (.lvlib) ein. LabVIEW fügt automatisch alle erzeugten VIs in diese Projektbibliotheksdatei ein und hängt die Dateierweiterung *.lvlib an.
5. Geben Sie den Pfad zu dem Verzeichnis, in dem die vom Assistenten erzeugten Dateien gespeichert werden sollen, in das Textfeld Pfad zur Projektbibliothek ein. Ein Verzeichnis kann auch mit Hilfe der Schaltfläche Durchsuchen ausgewählt werden.
6. (Optional) Um eine Kopie der DLL im Zielverzeichnis zu belassen, wählen Sie DLL in Zielverzeichnis kopieren.

Hinweis Es werden nur die angegebenen DLLs kopiert, nicht aber davon abhängige DLLs. Um sich zu vergewissern, dass die erzeugten VIs funktionieren, kopieren Sie alle abhängigen DLLs manuell in den Zielordner oder fügen Sie sie in den Suchpfad des Systems ein.

1. Klicken Sie anschließend auf Weiter, um zur Seite Fehlerbehandlungsmodus auswählen zu gelangen.
2. Wählen Sie aus dem Pulldown-Menü Fehlerbehandlungsmodus auswählen den Fehlerbehandlungsmodus aus, der für den größten Teil der Wrapper-VIs verwendet werden soll. Im Feld Beispielblockdiagramm wird das grundlegende Blockdiagramm angezeigt, das für die Wrapper-VIs erstellt wird. Wenn Sie mehrere Fehlerbehandlungsmodi auswählen möchten, können Sie den Assistenten erneut starten, die Option VIs für DLL aktualisieren auswählen und nur die VIs erzeugen, für die ein anderer Fehlerbehandlungsmodus verwendet werden soll.
3. Klicken Sie auf Weiter, um zur Seite VIs und Elemente konfigurieren zu gelangen.
4. Überprüfen Sie die Konfiguration für die VIs und Elemente, die erstellt werden sollen. Mit den Optionen auf den Registerkarten Einstellungen und Name und Beschreibung lassen sich VI- und Elementangaben für einen großen Teil der zu erstellenden VIs bearbeiten. Der Datentyp für jedes Element wird in einem Symbol dargestellt. Neben allen Datentypen, die LabVIEW nicht verarbeiten kann, wird ein Ausrufezeichen () angezeigt. Erstellen Sie für Datentypen, die nicht von LabVIEW unterstützt werden, ein benutzerdefiniertes Element und fügen Sie das Element in die erstellte Bibliothek ein, nachdem die Ausführung des Assistenten beendet ist.
5. Klicken Sie auf Weiter, um auf die Seite Zusammenfassung zu gelangen.
6. Sehen Sie sich die Zusammenfassung an. Um Änderungen vorzunehmen, klicken Sie auf Zurück.
7. Klicken Sie auf der Seite Zusammenfassung auf Erzeugen zum Erzeugen von Wrapper-VIs für die in der angegebenen DLL ausgewählten Funktionen. Auf der Seite Erzeugungsprozess wird der Fortschritt des Assistenten bei der Erzeugung der Wrapper-VIs angezeigt. Wenn die Erzeugung beendet ist, wird die Seite Beenden angezeigt.
8. Aktivieren Sie die Option Erzeugte Bibliothek öffnen, wenn die erzeugte Bibliothek nach dem Schließen des Assistenten geöffnet werden soll.
9. Aktivieren Sie die Option Protokoll anzeigen, wenn das Protokoll nach dem Schließen des Assistenten angezeigt werden soll. Bei Auswahl dieser Option wird das Protokoll im Standard-Webbrowser geöffnet.
10. Klicken Sie zum Schließen des Assistenten auf Beenden.
11. Überprüfen Sie die Projektbibliotheksdatei und die erzeugten Wrapper-VIs. Bei Auswahl eines Fehlerbehandlungsmodus, der ein Fehlerbehandlungs-VI aufruft, muss das Fehler-VI geöffnet und bearbeitet werden.

Unter Beispiel: Importieren von Funktionen aus einer DLL erfahren Sie mehr zum Erstellen und Aktualisieren einer Bibliothek von VIs entsprechend den Funktionen aus der Beispiel-DLL, ImportSharedLibraryExample.dll.