Unions 샘플

아티클
08/09/2011

이 샘플에서는 공용 구조체를 필요로 하는 관리되지 않는 함수에 값 형식만 포함된 구조체와 값 형식 및 문자열이 포함된 구조체를 매개 변수로 전달하는 방법을 보여 줍니다. 공용 구조체는 둘 이상의 변수가 공유할 수 있는 메모리 위치를 나타냅니다.

Unions 샘플에서는 다음의 관리되지 않는 함수를 사용합니다. 이 함수는 원래의 함수 선언과 함께 표시되어 있습니다.

PinvokeLib.dll에서 내보낸 TestUnion
```
void TestUnion(MYUNION u, int type);
```

PinvokeLib.dll은 이 함수와 두 개의 공용 구조체 MYUNION 및 MYUNION2에 대한 구현이 포함된, 관리되지 않는 사용자 지정 라이브러리입니다. 이 공용 구조체에는 다음 요소가 포함되어 있습니다.

union MYUNION
{
    int number;
    double d;
}

union MYUNION2
{
    int i;
    char str[128];
};

관리 코드에서는 공용 구조체가 구조체로 정의됩니다. MyUnion구조체에는 두 가지 값 형식인 정수 및 double이 멤버로 포함되어 있습니다. StructLayoutAttribute 특성은 각 데이터 멤버의 정확한 위치를 제어할 수 있도록 설정됩니다. FieldOffsetAttribute 특성을 사용하면 공용 구조체의 관리되지 않는 표현 내에서 필드의 실제 위치를 지정할 수 있습니다. 두 멤버 모두 동일한 오프셋을 가지므로 이 멤버들은 동일한 메모리 위치를 정의할 수 있습니다.

MyUnion2_1과 MyUnion2_2에는 각각 값 형식(정수)과 문자열이 포함되어 있습니다. 관리 코드에서는 값 형식과 참조 형식이 중복될 수 없습니다. 이 샘플에서는 메서드 오버로드를 사용함으로써 호출자가 동일한 관리되지 않는 함수를 호출할 때 두 형식을 모두 사용할 수 있도록 합니다. MyUnion2_1의 레이아웃은 명시적이며 정확한 오프셋 값을 가집니다. 반면, MyUnion2_2의 경우에는 참조 형식에 explicit 레이아웃을 사용할 수 없기 때문에 sequential 레이아웃이 적용됩니다. MarshalAsAttribute 특성은 UnmanagedType 열거형을 ByValTStr로 설정합니다. ByValTStr은 공용 구조체의 관리되지 않는 표현 내에 나타나는 고정 길이의 인라인 문자를 식별하는 데 사용됩니다.

LibWrap 클래스에는 TestUnion 및 TestUnion2 메서드의 프로토타입이 포함되어 있습니다. TestUnion2는 MyUnion2_1 또는 MyUnion2_2를 매개 변수로 선언하도록 오버로드됩니다.

프로토타입 선언

' Declares managed structures instead of unions.
<StructLayout(LayoutKind.Explicit)> _
Public Structure MyUnion
    <FieldOffset(0)> Public i As Integer
    <FieldOffset(0)> Public d As Double
End Structure 'MyUnion

<StructLayout(LayoutKind.Explicit, Size := 128)> _
Public Structure MyUnion2_1
    <FieldOffset(0)> Public i As Integer
End Structure 'MyUnion2_1

<StructLayout(LayoutKind.Sequential)> _
Public Structure MyUnion2_2
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst := 128)> _
    Public str As String
End Structure 'MyUnion2_2

Public Class LibWrap
    ' Declares managed prototypes for unmanaged function.
    Declare Sub TestUnion Lib "..\LIB\PinvokeLib.dll" ( _
        ByVal u As MyUnion, ByVal type As Integer)

    Overloads Declare Sub TestUnion2 Lib "..\LIB\PinvokeLib.dll" ( _
        ByVal u As MyUnion2_1, ByVal type As Integer)

    Overloads Declare Sub TestUnion2 Lib "..\LIB\PinvokeLib.dll" ( _
        ByVal u As MyUnion2_2, ByVal type As Integer)
End Class 'LibWrap

// Declares managed structures instead of unions.
[StructLayout(LayoutKind.Explicit)]
public struct MyUnion
{
    [FieldOffset(0)]
    public int i;
    [FieldOffset(0)]
    public double d;
}

[StructLayout(LayoutKind.Explicit, Size=128)]
public struct MyUnion2_1
{
    [FieldOffset(0)]
    public int i;
}

[StructLayout(LayoutKind.Sequential)]
public struct MyUnion2_2
{
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst=128)]
    public string str;
}

public class LibWrap
{
    // Declares managed prototypes for unmanaged function.
    [DllImport( "..\\LIB\\PInvokeLib.dll")]
    public static extern void TestUnion(MyUnion u, int type);

    [DllImport( "..\\LIB\\PInvokeLib.dll")]
    public static extern void TestUnion2(MyUnion2_1 u, int type);

    [DllImport( "..\\LIB\\PInvokeLib.dll")]
    public static extern void TestUnion2(MyUnion2_2 u, int type);
}

// Declares managed structures instead of unions.
[StructLayout(LayoutKind::Explicit)]
public value struct MyUnion
{
public:
    [FieldOffset(0)]
    int i;
    [FieldOffset(0)]
    double d;
};

[StructLayout(LayoutKind::Explicit, Size=128)]
public value struct MyUnion2_1
{
public:
    [FieldOffset(0)]
    int i;
};

[StructLayout(LayoutKind::Sequential)]
public value struct MyUnion2_2
{
public:
    [MarshalAs(UnmanagedType::ByValTStr, SizeConst=128)]
    String^ str;
};

public ref class LibWrap
{
public:
    // Declares managed prototypes for unmanaged function.
    [DllImport("..\\LIB\\PInvokeLib.dll")]
    static void TestUnion(MyUnion u, int type);

    [DllImport("..\\LIB\\PInvokeLib.dll")]
    static void TestUnion2(MyUnion2_1 u, int type);

    [DllImport("..\\LIB\\PInvokeLib.dll")]
    static void TestUnion2(MyUnion2_2 u, int type);
};

함수 호출

Public Class App
    Public Shared Sub Main()
        Dim mu As New MyUnion()
        mu.i = 99
        LibWrap.TestUnion(mu, 1)

        mu.d = 99.99
        LibWrap.TestUnion(mu, 2)

        Dim mu2_1 As New MyUnion2_1()
        mu2_1.i = 99
        LibWrap.TestUnion2(mu2_1, 1)

        Dim mu2_2 As New MyUnion2_2()
        mu2_2.str = "*** string ***"
        LibWrap.TestUnion2(mu2_2, 2)
    End Sub 'Main
End Class 'App

public class App
{
    public static void Main()
    {
        MyUnion mu = new MyUnion();
        mu.i = 99;
        LibWrap.TestUnion(mu, 1);

        mu.d = 99.99;
        LibWrap.TestUnion(mu, 2);

        MyUnion2_1 mu2_1 = new MyUnion2_1();
        mu2_1.i = 99;
        LibWrap.TestUnion2(mu2_1, 1);

        MyUnion2_2 mu2_2 = new MyUnion2_2();
        mu2_2.str = "*** string ***";
        LibWrap.TestUnion2(mu2_2, 2);
    }
}

public ref class App
{
public:
    static void Main()
    {
        MyUnion mu;// = new MyUnion();
        mu.i = 99;
        LibWrap::TestUnion(mu, 1);

        mu.d = 99.99;
        LibWrap::TestUnion(mu, 2);

        MyUnion2_1 mu2_1;// = new MyUnion2_1();
        mu2_1.i = 99;
        LibWrap::TestUnion2(mu2_1, 1);

        MyUnion2_2 mu2_2;// = new MyUnion2_2();
        mu2_2.str = "*** string ***";
        LibWrap::TestUnion2(mu2_2, 2);
    }
};

참고 항목

개념

클래스, 구조체 및 공용 구조체 마샬링

플랫폼 호출 데이터 형식

관리 코드에서 프로토타입 만들기

다음을 통해 공유

Unions 샘플

프로토타입 선언

함수 호출

참고 항목

개념

추가 리소스