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é.

C#

public enum CallingConvention

Héritage

Object

ValueType

Enum

CallingConvention

Champs

Nom	Valeur	Description
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.

C#

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

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.

S’applique à

Voir aussi

• DllImportAttribute
• System.Reflection.Emit