CallingConvention Énumération

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Spécifie la convention d’appel nécessaire pour appeler des méthodes implémentées dans du code non managé.

public enum class CallingConvention

public enum CallingConvention

type CallingConvention = 

Public Enum CallingConvention

Héritage

Object

ValueType

Enum

CallingConvention

Champs

Cdecl	2	L'appelant nettoie la pile. Cette procédure active les fonctions d'appel avec varargs qu'il convient d'utiliser pour les méthodes qui acceptent un nombre variable de paramètres tels que Printf.
FastCall	5	Cette conversion d'appel n'est pas prise en charge.
StdCall	3	L'appelé nettoie la pile.
ThisCall	4	Le premier paramètre est le pointeur this et est stocké dans le Registre ECX. D'autres paramètres font l'objet d'un push sur la pile. Cette convention d'appel est utilisée pour appeler des méthodes sur des classes exportées à partir d'une DLL non managée.
Winapi	1	Ce membre n’est pas en fait une convention d’appel, mais utilise plutôt la convention d’appel de plateforme par défaut.

Exemples

L’exemple suivant montre comment appliquer la Cdecl convention d’appel, que vous devez utiliser, car la pile est nettoyée par l’appelant.

using namespace System;
using namespace System::Runtime::InteropServices;

private ref class NativeMethods
{
public:

    // CallingConvention.Cdecl must be used since the stack is 
    // cleaned up by the caller.
    // int printf( const char *format [, argument]... )

    [DllImport("msvcrt.dll", CharSet = CharSet::Unicode, CallingConvention = CallingConvention::Cdecl)]
    static int printf(String^ format, int i, double d);

    [DllImport("msvcrt.dll", CharSet = CharSet::Unicode, CallingConvention = CallingConvention::Cdecl)]
    static int printf(String^ format, int i, String^ s);
};

int main()
{
    NativeMethods::printf("\nPrint params: %i %f", 99, 99.99);
    NativeMethods::printf("\nPrint params: %i %s", 99, "abcd");
}

using System;
using System.Runtime.InteropServices;

internal static class NativeMethods
{
    // C# doesn't support varargs so all arguments must be explicitly defined.
    // CallingConvention.Cdecl must be used since the stack is
    // cleaned up by the caller.

    // int printf( const char *format [, argument]... )

    [DllImport("msvcrt.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
    internal static extern int printf(String format, int i, double d);

    [DllImport("msvcrt.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
    internal static extern int printf(String format, int i, String s);
}

public class App
{
    public static void Main()
    {
        NativeMethods.printf("\nPrint params: %i %f", 99, 99.99);
        NativeMethods.printf("\nPrint params: %i %s", 99, "abcd");
    }
}

Imports System.Runtime.InteropServices

Friend Class NativeMethods
    ' Visual Basic does not support varargs, so all arguments must be 
    ' explicitly defined. CallingConvention.Cdecl must be used since the stack 
    ' is cleaned up by the caller. 
    ' int printf( const char *format [, argument]... )

    <DllImport("msvcrt.dll", CharSet:=CharSet.Unicode, CallingConvention:=CallingConvention.Cdecl)>
    Friend Overloads Shared Function printf(
        ByVal format As String, ByVal i As Integer, ByVal d As Double) As Integer
    End Function

    <DllImport("msvcrt.dll", CharSet:=CharSet.Unicode, CallingConvention:=CallingConvention.Cdecl)>
    Friend Overloads Shared Function printf(
        ByVal format As String, ByVal i As Integer, ByVal s As String) As Integer
    End Function
End Class

Public Class App
    Public Shared Sub Main()
        NativeMethods.printf(ControlChars.CrLf + "Print params: %i %f", 99, 99.99)
        NativeMethods.printf(ControlChars.CrLf + "Print params: %i %s", 99, "abcd")
    End Sub
End Class

Remarques

Utilisez toujours l’énumération CallingConvention plutôt que l’énumération CALLCONV pour spécifier une convention d’appel dans le code managé. Ce dernier n’existe que pour les définitions COM. L’énumération CallingConvention est utilisée par DllImportAttribute et plusieurs classes dans System.Reflection.Emit pour émettre dynamiquement des signatures d’appel de plateforme.

Voir aussi

• DllImportAttribute
• System.Reflection.Emit