Microsoft MVP성태의 닷넷 이야기
.NET Framework: 137. C#에서 Union 구조체 다루기 [링크 복사], [링크+제목 복사],
조회: 33523
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 1개 있습니다.)
(시리즈 글이 16개 있습니다.)
.NET Framework: 112. How to Interop DISPPARAMS
; https://www.sysnet.pe.kr/2/0/617

.NET Framework: 137. C#에서 Union 구조체 다루기
; https://www.sysnet.pe.kr/2/0/728

.NET Framework: 141. Win32 Interop - 크기가 정해지지 않은 배열을 C++에서 C#으로 전달하는 경우
; https://www.sysnet.pe.kr/2/0/737

.NET Framework: 168. [in,out] 배열을 C#에서 C/C++로 넘기는 방법
; https://www.sysnet.pe.kr/2/0/810

.NET Framework: 169. [in, out] 배열을 C#에서 C/C++로 넘기는 방법 - 두 번째 이야기
; https://www.sysnet.pe.kr/2/0/811

.NET Framework: 183. 구조체 포인터 인자에 대한 P/Invoke 정의
; https://www.sysnet.pe.kr/2/0/912

.NET Framework: 472. C/C++과 C# 사이의 메모리 할당/해제 방법
; https://www.sysnet.pe.kr/2/0/1784

.NET Framework: 620. C#에서 C/C++ 함수로 콜백 함수를 전달하는 예제 코드
; https://www.sysnet.pe.kr/2/0/11099

.NET Framework: 627. C++로 만든 DLL을 C#에서 사용하기
; https://www.sysnet.pe.kr/2/0/11111

.NET Framework: 686. C# - string 배열을 담은 구조체를 직렬화하는 방법
; https://www.sysnet.pe.kr/2/0/11319

.NET Framework: 757. 포인터 형 매개 변수를 갖는 C++ DLL의 함수를 C#에서 호출하는 방법
; https://www.sysnet.pe.kr/2/0/11533

.NET Framework: 978. C# - GUID 타입 전용의 UnmanagedType.LPStruct
; https://www.sysnet.pe.kr/2/0/12444

C/C++: 158. Visual C++ - IDL 구문 중 "unsigned long"을 인식하지 못하는 #import
; https://www.sysnet.pe.kr/2/0/13128

.NET Framework: 2058. [in,out] 배열을 C#에서 C/C++로 넘기는 방법 - 세 번째 이야기
; https://www.sysnet.pe.kr/2/0/13141

.NET Framework: 2083. C# - C++과의 연동을 위한 구조체의 fixed 배열 필드 사용 (2)
; https://www.sysnet.pe.kr/2/0/13205

닷넷: 2152. Win32 Interop - C/C++ DLL로부터 이중 포인터 버퍼를 C#으로 받는 예제
; https://www.sysnet.pe.kr/2/0/13429




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://learn.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# 프로젝트가 포함되어 있습니다.



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

[연관 글]






[최초 등록일: ]
[최종 수정일: 12/30/2022]

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

비밀번호

댓글 작성자
 




... 46  47  48  [49]  50  51  52  53  54  55  56  57  58  59  60  ...
NoWriterDateCnt.TitleFile(s)
12589정성태4/8/202113965.NET Framework: 1032. C# - Environment.OSVersion의 문제점 및 윈도우 운영체제의 버전을 구하는 다양한 방법 [1]
12588정성태4/7/202114855개발 환경 구성: 565. PowerShell - New-SelfSignedCertificate를 사용해 CA 인증서 생성 및 인증서 서명 방법
12587정성태4/6/202115739개발 환경 구성: 564. Windows 10 - ClickOnce 배포처럼 사용할 수 있는 MSIX 설치 파일 [1]
12586정성태4/5/202113028오류 유형: 710. Windows - Restart-Computer / shutdown 명령어 수행 시 Access is denied(E_ACCESSDENIED)
12585정성태4/5/202112556개발 환경 구성: 563. 기본 생성된 kubeconfig 파일의 내용을 새롭게 생성한 인증서로 구성하는 방법
12584정성태4/1/202113348개발 환경 구성: 562. kubeconfig 파일 없이 kubectl 옵션만으로 실행하는 방법
12583정성태3/29/202114817개발 환경 구성: 561. kubectl 수행 시 다른 k8s 클러스터로 접속하는 방법
12582정성태3/29/202113844오류 유형: 709. Visual C++ - 컴파일 에러 error C2059: syntax error: '__stdcall'
12581정성태3/28/202113766.NET Framework: 1031. WinForm/WPF에서 Console 창을 띄워 출력하는 방법 (2) - Output 디버깅 출력을 AllocConsole로 우회 [2]
12580정성태3/28/202111835오류 유형: 708. SQL Server Management Studio - Execution Timeout Expired.
12579정성태3/28/202112285오류 유형: 707. 중첩 가상화(Nested Virtualization) - The virtual machine could not be started because this platform does not support nested virtualization.
12578정성태3/27/202112483개발 환경 구성: 560. Docker Desktop for Windows 기반의 Kubernetes 구성 (2) - WSL 2 인스턴스에 kind가 구성한 k8s 서비스 위치
12577정성태3/26/202114622개발 환경 구성: 559. Docker Desktop for Windows 기반의 Kubernetes 구성 - WSL 2 인스턴스에 kind 도구로 k8s 클러스터 구성
12576정성태3/25/202112333개발 환경 구성: 558. Docker Desktop for Windows에서 DockerDesktopVM 기반의 Kubernetes 구성 (2) - k8s 서비스 위치
12575정성태3/24/202111096개발 환경 구성: 557. Docker Desktop for Windows에서 DockerDesktopVM 기반의 Kubernetes 구성
12574정성태3/23/202115985.NET Framework: 1030. C# Socket의 Close/Shutdown 동작 (동기 모드)
12573정성태3/22/202113499개발 환경 구성: 556. WSL 인스턴스 초기 설정 명령어 [1]
12572정성태3/22/202112857.NET Framework: 1029. C# - GC 호출로 인한 메모리 압축(Compaction)을 확인하는 방법파일 다운로드1
12571정성태3/21/202111738오류 유형: 706. WSL 2 기반으로 "Enable Kubernetes" 활성화 시 초기화 실패 [1]
12570정성태3/19/202116361개발 환경 구성: 555. openssl - CA로부터 인증받은 새로운 인증서를 생성하는 방법
12569정성태3/18/202115496개발 환경 구성: 554. WSL 인스턴스 export/import 방법 및 단축 아이콘 설정 방법
12568정성태3/18/202110440오류 유형: 705. C# 빌드 - Couldn't process file ... due to its being in the Internet or Restricted zone or having the mark of the web on the file.
12567정성태3/17/202112387개발 환경 구성: 553. Docker Desktop for Windows를 위한 k8s 대시보드 활성화 [1]
12566정성태3/17/202112605개발 환경 구성: 552. Kubernetes - kube-apiserver와 REST API 통신하는 방법 (Docker Desktop for Windows 환경)
12565정성태3/17/20219434오류 유형: 704. curl.exe 실행 시 dll not found 오류
12564정성태3/16/202110085VS.NET IDE: 160. 새 프로젝트 창에 C++/CLI 프로젝트 템플릿이 없는 경우
... 46  47  48  [49]  50  51  52  53  54  55  56  57  58  59  60  ...