.NET Framework
Platform Invoke

Sintassi

• [DllImport ("Example.dll")] statico extern void SetText (string inString);
• [DllImport ("Example.dll")] statico extern void GetText (StringBuilder outString);
• [MarshalAs (UnmanagedType.ByValTStr, SizeConst = 32)] stringa di testo;
• [MarshalAs (UnmanagedType.ByValArray, SizeConst = 128)] byte [] byteArr;
• [StructLayout (LayoutKind.Sequential)] public struct PERSON {...}
• [StructLayout (LayoutKind.Explicit)] struttura pubblica MarshaledUnion {[FieldOffset (0)] ...}

Chiamando una funzione dll Win32

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);
    }
}

Dichiarare una funzione come static extern stting DllImportAttribute con la relativa proprietà Value impostata sul nome .dll. Non dimenticare di utilizzare lo spazio dei nomi System.Runtime.InteropServices . Quindi chiamalo come un metodo statico regolare.

Il Platform Invocation Services si occuperà di caricare il file .dll e di trovare la tariffa desiderata. Il P / Invoke nella maggior parte dei casi semplici esegue anche il marshalling dei parametri e restituisce il valore da e verso la DLL (ovvero conversione da tipi di dati .NET a Win32 e viceversa).

Utilizzando l'API di Windows

Usa pinvoke.net .

Prima di dichiarare una funzione API extern Windows nel tuo codice, prova a cercarla su pinvoke.net . Molto probabilmente hanno già una dichiarazione adeguata con tutti i tipi di supporto e buoni esempi.

Matrici di marshalling

Matrici di tipo semplice

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

Matrici di stringa

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

Strutture di marshalling

Struttura semplice

Firma C ++:

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

void GetSpouse(PERSON person, LP_PERSON spouse);

Definizione C #

[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);

Strutturare con campi array di dimensioni sconosciute. Passando dentro

Firma C ++

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

void SetVector(VECTOR &vector);

Passato da codice gestito a codice non gestito, questo

L'array di data deve essere definito come IntPtr e la memoria deve essere allocata esplicitamente con Marshal.AllocHGlobal() (e liberata con Marshal.FreeHGlobal() ):

[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);

Strutturare con campi array di dimensioni sconosciute. ricevente

Firma C ++:

typedef struct
{
    char *name;
} USER;

bool GetCurrentUser(USER *user);

Quando tali dati vengono passati dal codice non gestito e la memoria viene allocata dalle funzioni non gestite, il chiamante gestito deve riceverlo in una variabile IntPrt e convertire il buffer in un array gestito. In caso di stringhe, esiste un metodo Marshal.PtrToStringAnsi() conveniente:

[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);

I sindacati di marshalling

Solo campi di tipo valore

Dichiarazione C ++

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

Dichiarazione C #

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

Miscelazione del tipo di valore e dei campi di riferimento

La sovrapposizione di un valore di riferimento con un tipo di valore 1 non è consentita, pertanto non è possibile utilizzare semplicemente il FieldOffset(0) text; FieldOffset(0) i; non verrà compilato per

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

e in genere è necessario utilizzare il marshalling personalizzato. Tuttavia, in casi particolari come questa tecnica più semplice si può usare:

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