Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 3개 있습니다.)

C# Marshal.PtrToStructure - The structure must not be a value class.

간단한 재현 코드는 다음과 같습니다.

using System;
using System.Runtime.InteropServices;

class Program
{
    static void Main(string[] args)
    {
        int size = Marshal.SizeOf(typeof(MyStruct));
        IntPtr pBuf = Marshal.AllocHGlobal(size);

        MyStruct instance = new MyStruct();

        Marshal.StructureToPtr(instance, pBuf, true);

        // 예외 발생
        Marshal.PtrToStructure(pBuf, instance);
    }
}

public struct MyStruct
{
    public int Age;
    public bool Married;
}

실행하면 다음과 같은 런타임 오류가 발생하는데,

// 처리되지 않은 예외: System.ArgumentException: 구조체는 값 클래스가 아니어야 합니다.

Unhandled Exception: System.ArgumentException: The structure must not be a value class.
Parameter name: structure
   at System.Runtime.InteropServices.Marshal.PtrToStructureHelper(IntPtr ptr, Object structure, Boolean allowValueClasses)
   at Program.Main(String[] args) in C:\ConsoleApp1\ConsoleApp1\Program.cs:line 15

일면 이해가 갑니다. 왜냐하면 값 형식의 특성상 "instance" 변수를 PtrToStructure에 넘겨줬을 때 아무리 발버둥 쳐도 instance에 값을 설정할 방법이 없기 때문입니다. (이게 가능하려면 애당초 ref 유형으로 인자를 전달해야 합니다.) 반면, struct라는 것이 이름에 포함되었다는 점과 대칭적이라는 점에서 한편으론 아쉬움이 남는 API 설계입니다.

이를 위한 해결책으로 2가지가 있습니다. 1) MyStruct를 class로 바꾸거나, 2) PtrToStructure의 또 다른 버전을 사용하는 것입니다.

첫 번째 방법의 경우, 다음과 같이 StructLayout을 지정한 class로 바꾸면 됩니다.

// struct의 경우 기본 LayoutKind가 Sequential
//public struct MyStruct
//{
//    public int Age;
//    public bool Married;
//}

[StructLayout(LayoutKind.Sequential)]
public class MyStruct
{
    public int Age;
    public bool Married;
}

그럼, StructureToPtr에 참조 주소가 복사되어 넘어가기 때문에 대상 메서드에서는 instance 변수의 값을 변경할 수 있습니다.

두 번째 방법이라면 기존 소스 코드의 변경 없이 PtrToStructure 측에서,

instance = (MyStruct)Marshal.PtrToStructure(pBuf, typeof(MyStruct));

아예 반환값으로 넘겨주는 버전을 사용하면 되고, 이 과정에서 박싱/언박싱을 동반하며 instance에 값이 복사됩니다.

(첨부 파일은 이 글의 예제 코드를 포함합니다.)




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 12/9/2020]

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)
14027정성태10/15/2025435닷넷: 2371. C# - CRC64 (System.IO.Hashing의 약식 버전)파일 다운로드1
14026정성태10/15/2025435닷넷: 2370. 닷넷 지원 정보의 "package-provided" 의미
14025정성태10/14/2025729Linux: 126. eBPF (bpf2go) - tcp_sendmsg 예제
14024정성태10/14/2025772오류 유형: 984. Whisper.net - System.Exception: 'Cannot dispose while processing, please use DisposeAsync instead.'
14023정성태10/12/20251201닷넷: 2369. C# / Whisper 모델 - 동영상의 음성을 인식해 자동으로 SRT 자막 파일을 생성 [1]파일 다운로드1
14022정성태10/10/20252079닷넷: 2368. C# / NAudio - (AI 학습을 위해) 무음 구간을 반영한 오디오 파일 분할파일 다운로드1
14021정성태10/6/20252663닷넷: 2367. C# - Youtube 동영상 다운로드 (YoutubeExplode 패키지) [1]파일 다운로드1
14020정성태10/2/20252295Linux: 125. eBPF - __attribute__((preserve_access_index)) 활용 사례
14019정성태10/1/20252427Linux: 124. eBPF - __sk_buff / sk_buff 구조체
14018정성태9/30/20251789닷넷: 2366. C# - UIAutomationClient를 이용해 시스템 트레이의 아이콘을 열거하는 방법파일 다운로드1
14017정성태9/29/20252257Linux: 123. eBPF (bpf2go) - BPF_PROG_TYPE_SOCKET_FILTER 예제 - SEC("socket")
14016정성태9/28/20252536Linux: 122. eBPF - __attribute__((preserve_access_index)) 사용법
14015정성태9/22/20251981닷넷: 2365. C# - FFMpegCore를 이용한 MP4 동영상으로부터 MP3 음원 추출 예제파일 다운로드1
14014정성태9/17/20251967닷넷: 2364. C# - stun.l.google.com을 사용해 공용 IP 주소와 포트를 알아내는 방법파일 다운로드1
14013정성태9/14/20252610닷넷: 2363. C# - Whisper.NET Library를 이용해 음성을 텍스트로 변환 및 번역하는 예제파일 다운로드1
14012정성태9/9/20252858닷넷: 2362. C# - Windows.Media.Ocr: 윈도우 운영체제에 포함된 OCR(Optical Character Recognition)파일 다운로드1
14011정성태9/7/20253485닷넷: 2361. C# - Linux 환경의 readlink 호출
14010정성태9/1/20253309오류 유형: 983. apt update 시 "The repository 'http://deb.debian.org/debian buster Release' does not have a Release file." 오류
14009정성태8/28/20253772닷넷: 2360. C# 14 - (11) Expression Tree에 선택적 인수와 명명된 인수 허용파일 다운로드1
14008정성태8/26/20254350닷넷: 2359. C# 14 - (10) 복합 대입 연산자의 오버로드 지원파일 다운로드1
14007정성태8/25/20254760닷넷: 2358. C# - 현재 빌드에 적용 중인 컴파일러 버전 확인 방법 (#error version)
14006정성태8/23/20255050Linux: 121. Linux - snap 패키지 관리자로 설치한 소프트웨어의 디렉터리 접근 제한
14005정성태8/21/20254026오류 유형: 982. sudo: unable to load /usr/libexec/sudo/sudoers.so: libssl.so.3: cannot open shared object file: No such file or directory
14004정성태8/21/20254613오류 유형: 981. dotnet 실행 시 No usable version of the libssl was found
14003정성태8/21/20254875닷넷: 2357. C# 14 - (9) 새로운 지시자 추가 (Ignored directives)
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...