Microsoft MVP성태의 닷넷 이야기
.NET Framework: 137. C#에서 Union 구조체 다루기 [링크 복사], [링크+제목 복사]
조회: 23609
글쓴 사람
정성태 (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
; https://docs.microsoft.com/en-us/archive/blogs/ericgu/arrays-inside-of-structures

결국, 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



[최초 등록일: ]
[최종 수정일: 7/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)
12839정성태9/15/2021324.NET Framework: 1118. C# 10 - (17) 제네릭 타입의 특성 적용파일 다운로드1
12838정성태9/13/2021306.NET Framework: 1117. C# - Task에 전달한 Action, Func 유형에 따라 달라지는 async/await 비동기 처리 [2]파일 다운로드1
12837정성태9/11/2021159VC++: 151. Golang - fmt.Errorf, errors.Is, errors.As 설명
12836정성태9/10/2021116Linux: 45. 리눅스 - 실행 중인 다른 프로그램의 출력을 확인하는 방법
12835정성태9/7/2021172.NET Framework: 1116. C# 10 - (16) CallerArgumentExpression 특성 추가파일 다운로드1
12834정성태9/7/202198오류 유형: 762. Visual Studio 2019 Build Tools - 'C:\Program' is not recognized as an internal or external command, operable program or batch file.
12833정성태9/6/2021193VC++: 150. Golang - TCP client/server echo 예제 코드파일 다운로드1
12832정성태9/6/202195VC++: 149. Golang - 인터페이스 포인터가 의미 있을까요?
12831정성태9/6/2021125VC++: 148. Golang - 채널에 따른 다중 작업 처리파일 다운로드1
12830정성태9/6/2021120오류 유형: 761. Internet Explorer에서 파일 다운로드 시 "Your current security settings do not allow this file to be downloaded." 오류
12829정성태9/5/2021216.NET Framework: 1115. C# 10 - (15) 구조체 타입에 기본 생성자 정의 가능파일 다운로드1
12828정성태9/4/2021245.NET Framework: 1114. C# 10 - (14) 단일 파일 내에 적용되는 namespace 선언파일 다운로드1
12827정성태9/4/2021120스크립트: 27. 파이썬 - 웹 페이지 데이터 수집을 위한 scrapy Crawler 사용법 요약
12826정성태9/3/2021177.NET Framework: 1113. C# 10 - (13) 문자열 보간 성능 개선파일 다운로드1
12825정성태9/3/202173개발 환경 구성: 603. GoLand - WSL 환경과 연동
12824정성태9/2/2021193오류 유형: 760. 파이썬 tensorflow - Dst tensor is not initialized. 오류 메시지
12823정성태9/2/2021171스크립트: 26. 파이썬 - PyCharm을 이용한 fork 디버그 방법
12822정성태9/1/2021102오류 유형: 759. 파이썬 tensorflow - ValueError: Shapes (...) and (...) are incompatible
12821정성태9/1/2021154.NET Framework: 1112. C# - .NET 6부터 공개된 ISpanFormattable 사용법
12820정성태9/1/202189VC++: 147. Golang - try/catch에 대응하는 panic/recover파일 다운로드1
12819정성태8/31/2021189.NET Framework: 1111. C# - FormattableString 타입
12818정성태8/31/2021133Windows: 198. 윈도우 - 작업 관리자에서 (tensorflow 등으로 인한) GPU 연산 부하 보는 방법
12817정성태8/31/202184스크립트: 25. 파이썬 - 윈도우 환경에서 directml을 이용한 tensorflow의 AMD GPU 사용 방법
12816정성태8/30/2021420스크립트: 24. 파이썬 - tensorflow 2.6 NVidia GPU 사용 방법 [2]
12815정성태8/30/2021214개발 환경 구성: 602. WSL 2 - docker-desktop-data, docker-desktop (%LOCALAPPDATA%\Docker\wsl\data\ext4.vhdx) 파일을 다른 디렉터리로 옮기는 방법
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...