Microsoft MVP성태의 닷넷 이야기
.NET Framework: 137. C#에서 Union 구조체 다루기 [링크 복사], [링크+제목 복사]
조회: 23171
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
C#에서 Union 구조체 다루기


가끔 고객사의 질문이 재미있는 경우가 있습니다.

CallbackOnCollectedDelegate was detected
; https://www.sysnet.pe.kr/2/0/710

이번에도 위의 ^^ C/C++ 관련 질문을 했던 그 고객사에서 질문을 해왔는데요. C/C++의 Union 구조체를 C#에서 만들어서 Win32 DLL 함수에 전달해야 하는데, 이 과정에서 오류가 발생한다는 것이었습니다. 고객사로부터 전달되어진 코드는 다음과 같습니다.

[StructLayoutAttribute(LayoutKind.Explicit)]
public struct InvalidUnionStruct
{
    [FieldOffsetAttribute(0)]
    public uint uintValue;
    [FieldOffsetAttribute(0)]
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 10, ArraySubType = UnmanagedType.U2)]
    public ushort [] ushortArrays;
}

static void Main(string[] args)
{
    InvalidUnionStruct union = new InvalidUnionStruct(); // 실행시키기 전에 오류 발생
}

오류 메시지는 다음과 같습니다.

An unhandled exception of type 'System.TypeLoadException' occurred in Unknown Module.

Additional information: Could not load type 'InteropTest.InvalidUnionStruct' from assembly 'InteropTest, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null' because it contains an object field at offset 0 that is incorrectly aligned or overlapped by a non-object field.



무슨 오류인지 대강 설명이 되지요. managed에서의 배열은 참조형이기 때문에 정상적으로 union 데이터 정렬에 맞춰질 수 없습니다. 단지, 오류가 나는 상황이 재미있는데 InvalidUnionStruct 구조체를 사용하기도 전에 Main 메서드가 JIT 컴파일되는 순간에 오류가 발생합니다.

문제 해결은 다음의 글에서 설명하는 것처럼 간단합니다.

Arrays inside of structures
; http://blogs.msdn.com/ericgu/archive/2004/08/12/213676.aspx

결국, C# 2.0부터 struct 멤버에 fixed 배열 선언이 가능해졌기 때문에 아래와 같이 수정을 하면 정상적으로 빌드할 수 있습니다.

[StructLayoutAttribute(LayoutKind.Explicit)]
public unsafe struct UnionStruct
{
    [FieldOffsetAttribute(0)] public uint uintValue;
    [FieldOffsetAttribute(0)] public fixed ushort ushortArrays[10];
}




위와 같이 답변을 해주었는데, 또 다시 메일이 왔습니다. 이번에는 그렇게 설정된 union 구조에 값을 넣고 Win32 DLL 함수에 전달하려는 데 다음과 같은 오류가 발생한다는 것이었습니다.

An unhandled exception of type 'System.TypeLoadException' occurred in InteropTest.exe

Additional information: Cannot marshal field 'ushortArrays' of type 'InteropTest.UnionStruct': Invalid managed/unmanaged type combination (this value type must be paired with Struct).

'InteropTest.UnionStruct'형식의 'ushortArrays'필드를 마샬링할 수 없습니다. 이 필드의 형식 정의에 레이아웃 정보가 있지만 관리되는/관리되지 않는 형식 조합이 잘못되었거나, 형식 정의를 마샬링할 수 없습니다.



보내온 코드는 다음과 같습니다.

[StructLayoutAttribute(LayoutKind.Explicit)]
public unsafe struct UnionStruct
{
    [FieldOffsetAttribute(0)] public uint uintValue;
    [MarshalAsAttribute(UnmanagedType.ByValArray, SizeConst = 7, ArraySubType = UnmanagedType.I2)]        
    [FieldOffsetAttribute(0)]
    public fixed ushort ushortArrays[10];
}

오류가 발생할 수 밖에 없습니다. fixed 배열을 선언했기 때문에 더 이상 MarshalAs로 지정해서는 안되기 때문입니다. 즉, "Invalid managed/unmanaged type combination"라는 메시지가 지적하고 있는 내용입니다. 물론, MarshalAs 특성을 제거하면 오류는 더 이상 발생하지 않습니다.




몇 가지 재미있는 팁을 더 알려드리자면.

이렇게 fixed를 포함하는 구조체의 크기를 구하려면 다음과 같이 2가지 방식을 사용할 수 있습니다.

UnionStruct item = new UnionStruct();
item.uintValue = 5;

int marshalSize;

// 첫 번째 방식: unsafe 문맥 안에서 sizeof 호출
unsafe
{
    marshalSize = sizeof(UnionStruct);
}

// 두 번째 방식: Marshal.SizeOf를 사용하여 인스턴스의 크기를 반환
int marshalSize = Marshal.SizeOf(item);         

fixed로 지정된 배열의 크기에 따라 위의 2가지 방식에서 속도차이가 확연하게 납니다.

10개
첫번째 방식: 18
두번째 방식: 65

100000 개
첫번째 방식: 18
두번째 방식: 2607

* Stopwatch 사용

아시겠지요? 첫 번째 방식은 타입 정보에 있는 것을 가져오는 정도로 끝나지만 두 번째 방식은 런타임시에 해당 인스턴스의 메모리 구조를 열람하면서 크기를 구하는 것입니다. (비록 첫 번째 방식이 빠르긴 하지만 상황에 따라서는 반드시 두 번째 방식을 써야할때도 있습니다.)




구조체를 Win32 DLL에서 export하고 있는 함수에 넘겨주는 방법도 2가지입니다. (사실, 코드를 꼬는 방법에 따라서 더 다양해질 수 있지만.)

예를 들어, 위의 구조체를 전달받는 C/C++ API의 signature가 다음과 같은 경우,

__declspec(dllexport) int fnInteropWin32(UnionStruct *Struct);

간단하게 DllImport에 ref 키워드를 사용해서 전달하는 방법과,

[DllImport("InteropWin32.dll")]
public static extern int fnInteropWin32(ref UnionStruct Struct);

UnionStruct item = new UnionStruct();
item.uintValue = 5;

fnInteropWin32(ref item)

ref 참조 전달 방식이 아닌 IntPtr로 전달하는 것도 가능합니다.

[DllImport("InteropWin32.dll")]
public static extern int fnInteropWin32(IntPtr pStruct);

UnionStruct item = new UnionStruct();
item.uintValue = 5;

int marshalSize;

unsafe
{
    marshalSize = sizeof(UnionStruct);
}

IntPtr pStruct = Marshal.AllocCoTaskMem(marshalSize);

Marshal.StructureToPtr(item, pStruct, false);
fnInteropWin32(pStruct);

Marshal.FreeCoTaskMem(pStruct);

이때 주의할 점은, 반드시 AllocCoTaskMem으로 할당한 메모리를 FreeCoTaskMem으로 풀어주어야 한다는 것입니다. (말할 필요도 없겠지만, 그렇지 않은 경우 메모리 누수 현상이 발생합니다.)

어느 방법을 선호할지는 개인 취향이겠지만, 당연히 ref를 이용한 참조 전달이 바람직하겠습니다. 물론 Interop이 매우 복잡한 경우에는 IntPtr로 구성해야 하는 경우도 생길 수도 있겠지만.

* 첨부된 솔루션 파일은 위의 사항을 테스트해볼 수 있는 C/C++프로젝트와 C#프로젝트가 포함되어 있습니다.



[이 토픽에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]


donaricano-btn



[최초 등록일: ]
[최종 수정일: 6/10/2021 ]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 쓴 사람
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12684정성태6/19/202118오류 유형: 728. Visual Studio 2022부터 DTE.get_Properties 속성 접근 시 System.MissingMethodException 예외 발생
12683정성태6/18/202145VS.NET IDE: 166. Visual Studio 2022 - Windows Forms 프로젝트의 x86 DLL 컨트롤이 Designer에서 오류가 발생하는 문제파일 다운로드1
12682정성태6/18/202152VS.NET IDE: 165. Visual Studio 2022를 위한 Extension 마이그레이션
12681정성태6/18/202131오류 유형: 727. .NET 2.0 ~ 3.5 + x64 환경에서 System.EnterpriseServices 참조 시 CS8012 경고
12680정성태6/18/202131오류 유형: 726. python2.7.exe 실행 시 0xc000007b 오류
12679정성태6/18/202151COM 개체 관련: 23. CoInitializeSecurity의 전역 설정을 재정의하는 CoSetProxyBlanket 함수 사용법파일 다운로드1
12678정성태6/17/202146.NET Framework: 1072. C# - CoCreateInstance 관련 Inteop 오류 정리파일 다운로드1
12677정성태6/17/202162VC++: 144. 역공학을 통한 lxssmanager.dll의 ILxssSession 사용법 분석파일 다운로드1
12676정성태6/16/202170VC++: 143. ionescu007/lxss github repo에 공개된 lxssmanager.dll의 CLSID_LxssUserSession/IID_ILxssSession 사용법파일 다운로드1
12675정성태6/16/202138Java: 20. maven package 명령어 결과물로 (war가 아닌) jar 생성 방법
12674정성태6/15/202166VC++: 142. DEFINE_GUID 사용법
12673정성태6/15/202141Java: 19. IntelliJ - 자바(Java)로 만드는 Web App을 Tomcat에서 실행하는 방법
12672정성태6/15/202132오류 유형: 725. IntelliJ에서 Java webapp 실행 시 "Address localhost:1099 is already in use" 오류
12671정성태6/15/202133오류 유형: 724. Tomcat 실행 시 Failed to initialize connector [Connector[HTTP/1.1-8080]] 오류
12670정성태6/13/202166.NET Framework: 1071. DLL Surrogate를 이용한 Out-of-process COM 개체에서의 CoInitializeSecurity 문제파일 다운로드1
12669정성태6/11/2021126.NET Framework: 1070. 사용자 정의 GetHashCode 메서드 구현은 C# 9.0의 record 또는 리팩터링에 맡기세요.
12668정성태6/11/2021132.NET Framework: 1069. C# - DLL Surrogate를 이용한 Out-of-process COM 개체 제작파일 다운로드2
12667정성태6/10/202189.NET Framework: 1068. COM+ 서버 응용 프로그램을 이용해 CoInitializeSecurity 제약 해결파일 다운로드1
12666정성태6/10/202170.NET Framework: 1067. 별도 DLL에 포함된 타입을 STAThread Main 메서드에서 사용하는 경우 CoInitializeSecurity 자동 호출파일 다운로드1
12665정성태6/9/2021124.NET Framework: 1066. Wslhub.Sdk 사용으로 알아보는 CoInitializeSecurity 사용 제약파일 다운로드1
12664정성태6/9/202187오류 유형: 723. COM+ PIA 참조 시 "This operation failed because the QueryInterface call on the COM component" 오류
12663정성태6/9/2021111.NET Framework: 1065. Windows Forms - 속성 창의 디자인 설정 지원: 문자열 목록 내에서 항목을 선택하는 TypeConverter 제작파일 다운로드1
12662정성태6/8/2021134.NET Framework: 1064. C# COM 개체를 PIA(Primary Interop Assembly)로써 "Embed Interop Types" 참조하는 방법파일 다운로드1
12661정성태6/4/2021261.NET Framework: 1063. C# - MQTT를 이용한 클라이언트/서버(Broker) 통신 예제 [3]파일 다운로드1
12660정성태6/3/2021194.NET Framework: 1062. Windows Forms - 폼 내에서 발생하는 마우스 이벤트를 자식 컨트롤 영역에 상관없이 수신하는 방법 [1]파일 다운로드1
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...