DLL-Methoden hinzufügen: Difference between revisions

From BlueM
Jump to navigation Jump to search
(Umstrukturierung)
Line 1: Line 1:
<div style="float:left; margin-right:10px">__TOC__</div>
<div style="float:left; margin-right:10px">__TOC__</div>
<big> Anleitung für das Hinzufügen neuer Methoden in eine Modell-DLL (am Beispiel von [[BlueM]]) </big><br clear="all"/>
* DLL Anbindungen
** .NET 2 FORTRAN
Zum Beispiel der DLLAdapter des BlueM Pakets [[DLL-Methoden hinzufügen (.NET 2 FORTRAN)]]
** FORTRAN 2 C++
Zum Beispiel die Anbindung des GueteModells an BlueM-Core [[DLL-Methoden hinzufügen (FORTRAN 2 C++)]]


== Hinzufügen der neuen Methode in der BlueM Fortran-DLL ==


<fortran>
        logical function GetModelDescription(Description)
        !DEC$ ATTRIBUTES DLLEXPORT :: GETMODELDESCRIPTION
        character(*) Description
            ...
        end function
</fortran>
* Funktionsname und DLLEXPORT-Name müssen gleich sein !
* Übergabeparameter müssen definiert sein (und die Typen sollten so einfach wie möglich sein) !
; Tip : Kontrollieren, ob der Export funktioniert hat, kann man mit dem DependencyWalker des Visual Studios <br/><code>C:\Programme\Microsoft Visual Studio 8\Common7\Tools\Bin\Depends.Exe</code>. <br/>Dort werden alle exportierte Methoden aufgelistet.
== Erweiterung des [[BlueM.DLLAdapter|DLL-Wrappers]] (C#) ==
Die Methoden der DLL werden aus der Klasse <code>DLLMethoden</code> aufgerufen.
# Hinzufügen des Delegats in DLLMethoden
# Hinzufügen der Schnittstellenmethode
# Hinzufügen einer Testmethode [[UnitTest]]
<csharp>
        public class DLLMethoden
        {     
                ...
                delegate bool GetModelDescriptionDelegate([MarshalAs(UnmanagedType.LPStr)] StringBuilder description, uint length);
                ...
                public bool GetModelDescription(StringBuilder description, uint length)
                {
                    if (myDll == IntPtr.Zero)
                        InitializeMyDll(pathToDll);
                    IntPtr pProc = DllImportDynamic.GetProcAddress(myDll, "OPENMI_mp_GETMODELDESCRIPTION");
                    GetModelDescriptionDelegate cpv = (GetModelDescriptionDelegate)Marshal.GetDelegateForFunctionPointer(pProc, typeof(GetModelDescriptionDelegate));
                    return cpv(description, (uint)description.Length);
                }       
                ...
        }
</csharp>
==== Delegate ====
Eine Delegatmethode ist eine Art "Platzhalter". in diesem Beispiel fungiert sie als Platzhalter für die Fortran-DLL. Sie hat die selben Übergabeparameter wie in der Fortran-DLL beschrieben - Ausnahme sind Zeichenketten (Siehe [[#Marshaling|Marshaling]]).
==== Marshaling ====
* Um Typensicherheit zu gewährleiseten, gibt es in .NET die Attributsklasse <code>MarshalAs</code>. Über diese Klasse können Typen aus unmanaged Code und dem .NET Code ausgetauscht werden - z.B. <code>r8</code> und <code>double</code> oder wie bei <code>GetModelDescriptionDelegate</code> eine Zeichenkette (<code>LPStr</code>/<code>StringBuilder</code>): 
<csharp> [MarshalAs(UnmanagedType.LPStr)] StringBuilder description </csharp>
* Um eine Zeichenkette mit der Fortran-DLL auszutauschen, muss zu dem inhalt immer auch die Länge des Strings angegeben werden:
<csharp> uint length </csharp>
==== Aufruf der DLL-Methode ====
<csharp>IntPtr pProc = DllImportDynamic.GetProcAddress(myDll, "OPENMI_mp_GETMODELDESCRIPTION");</csharp>
Holt sich die Einsprungadresse der DLL_Methode.
<csharp>GetModelDescriptionDelegate cpv = (GetModelDescriptionDelegate)Marshal.GetDelegateForFunctionPointer(pProc, typeof(GetModelDescriptionDelegate));</csharp>
Die Einsprungadresse und der "Platzhalter" werden miteinander verknüpft. Nun kann man einfach die Delegatmethode mit den entsprechenden Parametern aufrufen:
<csharp>cpv(description, (uint)description.Length);</csharp>
[[Kategorie:OpenMI]]
[[Kategorie:Hilfe]]
[[Kategorie:Hilfe]]
[[Kategorie:BlueM Code]]
[[Kategorie:BlueM Code]]
[[Kategorie:BlueM Entwicklung]]
[[Kategorie:BlueM Entwicklung]]

Revision as of 04:38, 20 May 2008

  • DLL Anbindungen
    • .NET 2 FORTRAN

Zum Beispiel der DLLAdapter des BlueM Pakets DLL-Methoden hinzufügen (.NET 2 FORTRAN)

    • FORTRAN 2 C++

Zum Beispiel die Anbindung des GueteModells an BlueM-Core DLL-Methoden hinzufügen (FORTRAN 2 C++)

Retrieved from "https://wiki.bluemodel.org/index.php?title=DLL-Methoden_hinzufügen&oldid=5167"