無効なランタイム マーシャリング

System.Runtime.CompilerServices.DisableRuntimeMarshallingAttribute 属性がアセンブリに適用されると、マネージド表現とネイティブ表現の間のデータ マーシャリングに関するほとんどの組み込みサポートが、ランタイムによって無効にされます。 この記事では、マーシャリングが無効にされたときに、無効になる機能と、.NET 型のネイティブ型へのマップ方法について説明します。

マーシャリングが無効にされるシナリオ

DisableRuntimeMarshallingAttribute がアセンブリに適用されると、アセンブリ内の P/invoke および Delegate 型と、アセンブリ内でのアンマネージド関数ポインターの呼び出しに、影響があります。 他のアセンブリで定義されている P/Invoke または相互運用デリゲート型には影響しません。 また、ランタイムの組み込み COM 相互運用サポートに関するマーシャリングが無効になることもありません。 組み込み COM 相互運用のサポートは、機能スイッチを使って有効または無効にすることができます。

無効になる機能

DisableRuntimeMarshallingAttribute がアセンブリに適用されると、次の属性は効果がなくなるか、例外をスローします。

• LCIDConversionAttribute (P/Invoke またはデリゲート)
• SetLastError=true (P/Invoke)
• ThrowOnUnmappableChar=true (P/Invoke)
• BestFitMapping=true (P/Invoke)
• .NET の可変個引数のメソッドのシグネチャ (varargs)
• in、ref、out パラメーター

共通型をマーシャリングする場合の既定の規則

マーシャリングが無効になると、既定のマーシャリングの規則は、はるかに単純な規則に変わります。 これらの規則について以下で説明します。 相互運用のベスト プラクティスに関するドキュメントで説明されているように、blittable 型はマネージド コードとネイティブ コードでレイアウトが同じ型であるため、マーシャリングを必要としません。 また、これらの規則は、パラメーターのマーシャリングのカスタマイズに関するドキュメントで説明されているツールを使ってカスタマイズすることはできません。

C# キーワード	.NET 型	ネイティブ型
byte	System.Byte	uint8_t
sbyte	System.SByte	int8_t
short	System.Int16	int16_t
ushort	System.UInt16	uint16_t
int	System.Int32	int32_t
uint	System.UInt32	uint32_t
long	System.Int64	int64_t
ulong	System.UInt64	uint64_t
char	System.Char	char16_t (P/Invoke の CharSet には影響ありません)
nint	System.IntPtr	intptr_t
nuint	System.UIntPtr	uintptr_t
	System.Boolean	bool
	LayoutKind.Auto であるフィールドがないユーザー定義の C# unmanaged 型	blittable 型として扱われます。 カスタマイズされた構造体のマーシャリングはすべて無視されます。
	その他のすべての型	サポートされていない

例

次の例では、ランタイム マーシャリングが無効になると有効または無効にされるいくつかの機能を示します。

using System.Runtime.InteropServices;

struct Unmanaged
{
    int i;
}

[StructLayout(LayoutKind.Auto)]
struct AutoLayout
{
    int i;
}

struct StructWithAutoLayoutField
{
    AutoLayout f;
}

[UnmanagedFunctionPointer] // OK: UnmanagedFunctionPointer attribute is supported
public delegate void Callback();

[UnmanagedFunctionPointer(CallingConvention.Cdecl)] // OK: Specifying a calling convention is supported
public delegate void Callback2(int i); // OK: primitive value types are allowed

[DllImport("NativeLibrary", EntryPoint = "CustomEntryPointName")] // OK: Specifying a custom entry-point name is supported
public static extern void Import(int i);

[DllImport("NativeLibrary", CallingConvention = CallingConvention.Cdecl)] // OK: Specifying a custom calling convention is supported
public static extern void Import(int i);

[UnmanagedCallConv(new[] { typeof(CallConvCdecl) })] // OK: Specifying a custom calling convention is supported
[DllImport("NativeLibrary")]
public static extern void Import(int i);

[DllImport("NativeLibrary", EntryPoint = "CustomEntryPointName", CharSet = CharSet.Unicode, ExactSpelling = false)] // OK: Specifying a custom entry-point name and using CharSet-based lookup is supported
public static extern void Import(int i);

[DllImport("NativeLibrary")] // OK: Not explicitly specifying an entry-point name is supported
public static extern void Import(Unmanaged u); // OK: unmanaged type

[DllImport("NativeLibrary")] // OK: Not explicitly specifying an entry-point name is supported
public static extern void Import(StructWithAutoLayoutField u); // Error: unmanaged type with auto-layout field

[DllImport("NativeLibrary")]
public static extern void Import(Callback callback); // Error: managed types are not supported when runtime marshalling is disabled