.NET Framework
Plattform påkalla

Syntax

• [DllImport ("Exempel.dll")] statisk extern tomgång SetText (string inString);
• [DllImport ("Exempel.dll")] statisk extern tomgång GetText (StringBuilder outString);
• [MarshalAs (UnmanagedType.ByValTStr, SizeConst = 32)] strängtext;
• [MarshalAs (UnmanagedType.ByValArray, SizeConst = 128)] byte [] byteArr;
• [StructLayout (LayoutKind.Sequential)] public struct PERSON {...}
• [StructLayout (LayoutKind.Explicit)] public struct MarshaledUnion {[FieldOffset (0)] ...}

Ringa en Win32 dll-funktion

using System.Runtime.InteropServices;

class PInvokeExample
{
    [DllImport("user32.dll", CharSet = CharSet.Auto)]
    public static extern uint MessageBox(IntPtr hWnd, String text, String caption, int options);

    public static void test()
    {
        MessageBox(IntPtr.Zero, "Hello!", "Message", 0);
    }
}

Förklara en funktion som static extern stting DllImportAttribute med egenskapen Value inställd på .dll-namn. Glöm inte att använda System.Runtime.InteropServices namnutrymme. Sedan kalla det som en vanlig statisk metod.

Platforminvokationstjänsterna kommer att ta hand om att ladda .dll och hitta den önskade avslutningen. P / Invoke kommer i de flesta enkla fall också att marschera parametrar och returnera värdet till och från .dll (dvs. konvertera från. NET-datatyper till Win32-sådana och vice versa).

Använda Windows API

Använd pinvoke.net .

Innan du förklarar en extern Windows API-funktion i din kod, överväg att leta efter den på pinvoke.net . De har troligen redan en lämplig deklaration med alla stödjande typer och goda exempel.

Marshallande matriser

Matriser av enkel typ

[DllImport("Example.dll")]
static extern void SetArray(
    [MarshalAs(UnmanagedType.LPArray, SizeConst = 128)]
    byte[] data);

Uppsättningar av sträng

[DllImport("Example.dll")]
static extern void SetStrArray(string[] textLines);

Marshalera strukturer

Enkel struktur

C ++ signatur:

typedef struct _PERSON
{
    int age;
    char name[32];
} PERSON, *LP_PERSON;

void GetSpouse(PERSON person, LP_PERSON spouse);

C # definition

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)]
public struct PERSON
{
    public int age;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)]
    public string name;
}

[DllImport("family.dll", CharSet = CharSet.Auto)]
public static extern bool GetSpouse(PERSON person, ref PERSON spouse);

Struktur med arrayfält med okänd storlek. Passerar in

C ++ signatur

typedef struct
{
    int length;
    int *data;
} VECTOR;

void SetVector(VECTOR &vector);

När det skickas från hanterad till obestämd kod, detta

Den data array bör definieras som IntPtr och minne bör uttryckligen allokeras med Marshal.AllocHGlobal() (och befriades med Marshal.FreeHGlobal() efteråt):

[StructLayout(LayoutKind.Sequential)]
public struct VECTOR : IDisposable
{
    int length;
    IntPtr dataBuf;

    public int[] data
    {
        set
        {
            FreeDataBuf();
            if (value != null && value.Length > 0)
            {
                dataBuf = Marshal.AllocHGlobal(value.Length * Marshal.SizeOf(value[0]));
                Marshal.Copy(value, 0, dataBuf, value.Length);
                length = value.Length;
            }
        }
    }
    void FreeDataBuf()
    {
        if (dataBuf != IntPtr.Zero)
        {
            Marshal.FreeHGlobal(dataBuf);
            dataBuf = IntPtr.Zero;
        }
    }
    public void Dispose()
    {
        FreeDataBuf();
    }
}

[DllImport("vectors.dll")]
public static extern void SetVector([In]ref VECTOR vector);

Struktur med arrayfält med okänd storlek. Tar emot

C ++ signatur:

typedef struct
{
    char *name;
} USER;

bool GetCurrentUser(USER *user);

När sådan data skickas utan obehörig kod och minnet allokeras av de ostyrda funktionerna, bör den hanterade uppringaren ta emot den i en IntPrt variabel och konvertera bufferten till en hanterad matris. Vid strängar finns det en praktisk Marshal.PtrToStringAnsi() -metod:

[StructLayout(LayoutKind.Sequential)]
public struct USER
{
    IntPtr nameBuffer;
    public string name { get { return Marshal.PtrToStringAnsi(nameBuffer); } }
}

[DllImport("users.dll")]
public static extern bool GetCurrentUser(out USER user);

Marshalera fackföreningar

Endast värdetypfält

C ++ -deklaration

typedef union
{
    char c;
    int i;
} CharOrInt;

C # -deklaration

[StructLayout(LayoutKind.Explicit)]
public struct CharOrInt
{
    [FieldOffset(0)]
    public byte c;
    [FieldOffset(0)]
    public int i;
}

Blanda värdetyp och referensfält

Överlappning av ett referensvärde med en värdetyp är inte tillåtet så du kan inte bara använda FieldOffset(0) text; FieldOffset(0) i; kommer inte att sammanställas för

typedef union
{
    char text[128];
    int i;
} TextOrInt;

och i allmänhet skulle du behöva använda anpassad marskalkning. I vissa fall som den här enklare tekniken kan emellertid användas:

[StructLayout(LayoutKind.Sequential)]
public struct TextOrInt
{
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 128)]
    public byte[] text;
    public int i { get { return BitConverter.ToInt32(text, 0); } }
}