CallingConvention Výčet

  • Reference

Definice

Obor názvů:
System.Runtime.InteropServices
Sestavení:
System.Runtime.InteropServices.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Určuje konvenci volání vyžadovanou pro volání metod implementovaných v nespravovaném kódu.

public enum class CallingConvention
public enum CallingConvention
[System.Serializable]
public enum CallingConvention
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum CallingConvention
type CallingConvention = 
[<System.Serializable>]
type CallingConvention = 
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CallingConvention = 
Public Enum CallingConvention
Dědičnost
Object
ValueType
Enum
CallingConvention
Atributy
SerializableAttribute ComVisibleAttribute

Pole

Cdecl 2

Volající vyčistí zásobník. To umožňuje volat funkce pomocí varargs, což je vhodné použít pro metody, které přijímají proměnný počet parametrů, například Printf.
FastCall 5

Tato konvence volání není podporována.
StdCall 3

Volaný vyčistí zásobník.
ThisCall 4

První parametr je this ukazatel a je uložený v registru ECX. Do zásobníku se nasdílí další parametry. Tato konvence volání se používá k volání metod na třídách exportovaných z nespravované knihovny DLL.
Winapi 1

Tento člen ve skutečnosti není konvencí volání, ale místo toho používá výchozí konvenci volání platformy.

Příklady

Následující příklad ukazuje, jak použít Cdecl konvenci volání, kterou musíte použít, protože zásobník je vyčištěn volající.

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

Poznámky

K určení konvence volání ve spravovaném CallingConvention kódu vždy používejte výčet místo výčtu CALLCONV . Druhá možnost existuje pouze v zájmu definic modelu COM. Výčet CallingConvention se používá DllImportAttribute a několik tříd v System.Reflection.Emit k dynamickému generování podpisů volání platformy.

Platí pro

Viz také