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)
13959정성태6/25/2025985오류 유형: 966. Ubuntu - ping: connect: Network is unreachable
13958정성태6/21/20251479닷넷: 2339. C# - Phi-4-multimodal 모델의 GPU 가속 방법 (ORT 사용)파일 다운로드1
13957정성태6/20/20251437닷넷: 2338. C# / Foundry Local - Phi-4-multimodal 모델을 사용하는 방법
13956정성태6/19/20251609개발 환경 구성: 751. Triton Inference Server의 Python Backend 프로세스
13955정성태6/18/20251754오류 유형: 965. Hugging Face 모델 다운로드 시 "requests.exceptions.HTTPError: 401 Client Error: Unauthorized for url: ..." 오류
13954정성태6/18/20251564닷넷: 2337. C# - Hugging Face에 공개된 LLM 모델을 Foundry Local에서 사용하는 방법파일 다운로드1
13953정성태6/16/20251399스크립트: 78. 파이썬 - 소스 코드의 파일 경로를 지정한 모듈 로드
13952정성태6/15/20251741닷넷: 2336. C# - IValueTaskSource로 인해 주의가 필요한 ValueTask 호출파일 다운로드1
13951정성태6/15/20251623오류 유형: 964. Outlook - 일정이 "You cannot make changes to contents of this read-only folder." 오류 메시지로 삭제가 안 되는 경우
13950정성태6/12/20252071닷넷: 2335. C# - 간단하게 구현해 보는 IValueTaskSource 예제파일 다운로드1
13949정성태6/11/20251803오류 유형: 963. SignTool - "Error: SignerSign() failed." (-2146869243/0x80096005)
13948정성태6/10/20251411오류 유형: 962. 파이썬 - Linux 환경 + TCP 서버 소켓을 사용하는 프로세스 종료 후 재실행하는 경우 "OSError: [Errno 98] Address already in use" 오류 발생
13947정성태6/9/20251901개발 환경 구성: 750. 파이썬 - Azure App Service에 응용 프로그램 배포 후의 환경
13946정성태6/9/20252014개발 환경 구성: 749. 파이썬 - Azure App Service에 응용 프로그램 배포하기 전의 환경
13945정성태6/7/20251722오류 유형: 961. 파이썬 + conda - mysqlclient 사용 시 "NameError: name '_mysql' is not defined" 에러
13944정성태6/7/20255464오류 유형: 960. The trust relationship between this workstation and the primary domain failed. - 네 번째 이야기
13943정성태6/6/20252073개발 환경 구성: 748. Windows + Foundry Local - 로컬에서 AI 모델 활용 [1]
13942정성태6/5/20251686오류 유형: 959. winget 설치 시 "0x80d02002 : unknown error"
13941정성태6/2/20251508닷넷: 2334. C# - cpuid 명령어를 이용한 CPU 제조사 문자열 가져오기파일 다운로드1
13940정성태6/1/20251947C/C++: 188. C++의 32비트 + Release 어셈블리 코드를 .NET으로 포팅할 때 주의할 점파일 다운로드1
13939정성태5/29/20252284오류 유형: 958. NVIDIA Triton Inference Server - version `GLIBCXX_3.4.32' not found (required by /opt/tritonserver/backends/python/triton_python_backend_stub)
13938정성태5/29/20251779개발 환경 구성: 747. 파이썬 - WSL/docker에 구성한 Triton 예제 개발 환경
13937정성태5/24/20251693개발 환경 구성: 746. Windows + WSL2 환경에서 (tensorflow 등의) NVIDIA GPU 인식
13936정성태5/23/20251569개발 환경 구성: 745. Linux / WSL 환경에 Miniconda 설치하기
13935정성태5/20/20251734오류 유형: 957. 파이썬 - pip 사용 시 "ImportError: cannot import name 'html5lib' from 'pip._vendor'" 오류
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...