Microsoft MVP성태의 닷넷 이야기
.NET Framework: 627. C++로 만든 DLL을 C#에서 사용하기 [링크 복사], [링크+제목 복사],
조회: 28287
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 6개 있습니다.)
(시리즈 글이 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++로 만든 DLL을 C#에서 사용하기

우연히, 다음의 글을 접하게 되었습니다.

C++로 만든 DLL을 C#에서 사용하기
; http://pay114.cafe24.com/?m=bbs&bid=008&uid=706

오호~~~ 그러고 보니, 제 블로그에서 한 번도 이에 대한 설명을 한 적이 없군요. 대신, 다음의 글들에서 당연하게 사용한 정도입니다.

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

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

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

그런데, "C++로 만든 DLL을 C#에서 사용하기" 글을 보면 이상한 설명이 끼어 있습니다. 바로 "C++ 프로젝트 Property Setting"에서 "Common Language Runtime support"의 "/clr" 옵션을 지정하라는 것입니다. 만약 이 제약이 사실이라면, 기존 제작된 모든 Win32 DLL들은 모두 새로 컴파일해야만 합니다. 게다가 소스 코드가 없는 외부 DLL이라면 이런 경우 방법이 없다는 것이고.

물론, 저 단계는 필요 없습니다.




간단하게 해당 블로그에서 했던 내용을 재현해 볼까요? 소스 코드는 지난번 글의 예제를 그대로 사용하겠습니다.

C#에서 C/C++ 함수로 콜백 함수를 전달하는 예제 코드
 - pinvoke_callback_sample.zip 
; https://www.sysnet.pe.kr/bbs/DownloadAttachment.aspx?fid=1080&boardid=331301885

위의 예제 프로젝트의 Win32Project1에 다음의 코드를 각각 추가하고,

// Win32Project1.h

...[생략]...

extern "C"
{
    // ...[생략]...
    __declspec(dllexport)  int fnWin32Project2(int value);
};

// Win32Project1.cpp

...[생략]...

__declspec(dllexport) int fnWin32Project2(int value)
{
    return value;
}

빌드한 후, C#에서 이렇게 불러주면,

[DllImport("Win32Project1.dll")]
static extern int fnWin32Project2(int value);

static void Main(string[] args)
{
    Console.WriteLine(fnWin32Project2(52));
}

다음과 같은 예외가 발생합니다.

Managed Debugging Assistant 'PInvokeStackImbalance' has detected a problem in 'C:\...\ConsoleApplication1\bin\Debug\ConsoleApplication1.exe'.

Additional information: A call to PInvoke function 'ConsoleApplication1!Program::fnWin32Project2' has unbalanced the stack. This is likely because the managed PInvoke signature does not match the unmanaged target signature. Check that the calling convention and parameters of the PInvoke signature match the target unmanaged signature.
If there is a handler for this exception, the program may be safely continued.


이유는 간단합니다. 위의 오류 메시지에서도 나오듯이, "calling convention"이 틀리기 때문입니다. 실제로, 새로 추가된 fnWin32Project2 함수를 depends.exe로 확인해 보면,

cpp_dll_for_cs_1.png

_fnWin32Project1@8
fnWin32Project2

함수명 이름 앞에 "_" 밑줄도 없고 '@' + '[인자에 소비된 바이트 수]' 표기도 없습니다. 우리가 작성한 함수의 경우 호출 규약이 "cdecl"로 설정되어 있기 때문입니다. 이런 경우, 그냥 C# 함수에서 호출 규약만 맞춰주면 문제는 해결됩니다. 따라서, DllImport에 그것만 다음과 같이 명시해 줍니다.

[DllImport("Win32Project1.dll", CallingConvention=CallingConvention.Cdecl)]
static extern int fnWin32Project2(int value);

이렇게 하고 실행하면 아무런 예외 없이 잘 실행됩니다.




당연하겠지만, DllImport로 지정된 C# 메서드 선언은 기본 호출 규약이 StdCall입니다. 따라서 위와 같이 C# 측에서 바꿔주어도 되지만, C++ 측에서 애당초 다음과 같이 __stdcall로 명시해주는 것도 한 방법입니다. (물론, 이 방법은 C/C++ 소스 코드가 자신의 관리하에 있다는 조건이 필요합니다.)

// Win32Project1.h

...[생략]...

extern "C"
{
    // ...[생략]...
    __declspec(dllexport) __stdcall int fnWin32Project2(int value);
};

// Win32Project1.cpp

...[생략]...

__declspec(dllexport) __stdcall int fnWin32Project2(int value)
{
    return value;
}

다시 처음의 의문으로 돌아가서, 그렇다면 왜 /clr 옵션을 추가해서 C++ DLL 프로젝트를 빌드하면 C#에서 잘 호출되었을까요?

사실 잘 모르겠습니다. ^^; 아마도 해당 블로그의 저자가 사용한 Visual Studio의 컴파일러에서는, /clr 옵션이 걸리면 호출 규약이 명시되지 않은 export 함수들에 대해 __cdecl이 아닌 __stdcall로 한 것이 아닌가 생각됩니다. 만약, 그렇게 처리를 해준 것이라면 C# 측의 DllImport에 호출 규약을 Cdecl로 바꾸지 않았는데도 제대로 호출된 것에 대한 설명이 가능합니다.




마지막으로, 혹시나 한마디 더!

x64로 빌드하면 기본 호출 규약이 "__fastcall"로 바뀝니다.

x64 software conventions
; https://learn.microsoft.com/en-us/cpp/build/x64-software-conventions

그렇다면 C# 소스 코드에서 DllImport에 명시한 CallingConvention=CallingConvention.Cdecl 설정을 x64로 빌드할 때는 바꿔주어야 하는 것일까요? 그럴 필요 없습니다. x64로 빌드되면, 모든 호출 규약 설정을 무시하고 암시적으로 FastCall 규약을 사용하기 때문입니다.

참고로, 전에 제가 겪은 시행착오 하나 소개하면서 끝을 맺습니다. ^^

JNI DLL 컴파일 시 x86과 x64의 Export된 함수의 이름이 왜 다를까요?
; https://www.sysnet.pe.kr/2/0/1199




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

[연관 글]






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

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

비밀번호

댓글 작성자
 



2017-03-30 02시30분
이글에 대해 좀더 자세한 설명을 추가한 글이 있습니다.

C# 개발자를 위한 Win32 DLL export 함수의 호출 규약 (1) - x86 환경에서의 __cdecl, __stdcall에 대한 Name mangling
; http://www.sysnet.pe.kr/2/0/11132
정성태
2018-07-06 02시36분
정성태

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13655정성태6/24/2024419닷넷: 2269. C# - Win32 Resource 포맷 해석파일 다운로드1
13654정성태6/24/2024417오류 유형: 911. shutdown - The entered computer name is not valid or remote shutdown is not supported on the target computer.
13653정성태6/22/2024449닷넷: 2268. C# 코드에서 MAKEINTREOURCE 매크로 처리
13652정성태6/21/2024629닷넷: 2267. C# - Linux 환경에서 (Reflection 없이) DLL AssemblyFileVersion 구하는 방법파일 다운로드2
13651정성태6/19/2024678닷넷: 2266. C# - (Reflection 없이) DLL AssemblyFileVersion 구하는 방법파일 다운로드1
13650정성태6/18/2024812개발 환경 구성: 713. "WSL --debug-shell"로 살펴보는 WSL 2 VM의 리눅스 환경
13649정성태6/18/2024750오류 유형: 910. windbg - !py 확장 명령어 실행 시 "failed to find python interpreter" (2)
13648정성태6/17/2024816오류 유형: 909. C# - DynamicMethod 사용 시 System.TypeAccessException
13647정성태6/16/20241103개발 환경 구성: 712. Windows - WSL 2의 네트워크 통신 방법 - 세 번째 이야기 (같은 IP를 공유하는 WSL 2 인스턴스)
13646정성태6/14/2024829오류 유형: 908. Process Explorer - "Error configuring dump resources: The system cannot find the file specified."
13645정성태6/13/20241197개발 환경 구성: 711. Visual Studio로 개발 시 기본 등록하는 dev tag 이미지로 Docker Desktop k8s에서 실행하는 방법
13644정성태6/12/20241200닷넷: 2265. C# - System.Text.Json의 기본적인 (한글 등에서의) escape 처리
13643정성태6/12/20241179오류 유형: 907. MySqlConnector 사용 시 System.IO.FileLoadException 오류
13642정성태6/11/20241142스크립트: 65. 파이썬 - asgi 버전(2, 3)에 따라 달라지는 uvicorn 호스팅
13641정성태6/11/20241195Linux: 71. Ubuntu 20.04를 22.04로 업데이트
13640정성태6/10/20241183Phone: 21. C# MAUI - Android 환경에서의 파일 다운로드(DownloadManager)
13639정성태6/8/20241092오류 유형: 906. C# MAUI - Android Emulator에서 "Waiting For Debugger"로 무한 대기
13638정성태6/8/20241182오류 유형: 905. C# MAUI - 추가한 layout XML 파일이 Resource.Layout 멤버로 나오지 않는 문제
13637정성태6/6/20241242Phone: 20. C# MAUI - 유튜브 동영상을 MediaElement로 재생하는 방법
13636정성태5/30/20241279닷넷: 2264. C# - 형식 인자로 인터페이스를 갖는 제네릭 타입으로의 형변환파일 다운로드1
13635정성태5/29/20241068Phone: 19. C# MAUI - 안드로이드 "Share" 대상으로 등록하는 방법
13634정성태5/24/20241615Phone: 18. C# MAUI - 안드로이드 플랫폼에서의 Activity 제어
13633정성태5/22/20241611스크립트: 64. 파이썬 - ASGI를 만족하는 최소한의 구현 코드
13632정성태5/20/20241704Phone: 17. C# MAUI - Android 내에 Web 서비스 호스팅
13631정성태5/19/20241666Phone: 16. C# MAUI - /Download 등의 공용 디렉터리에 접근하는 방법
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...