Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 2개 있습니다.)
(시리즈 글이 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




[in,out] 배열을 C#에서 C/C++로 넘기는 방법 - 세 번째 이야기

아래와 같은 질문이 있군요,

델파이 dll을 c#에서 사용하기 관련해서 포인트 관련이라 질문을 올립니다.
; https://www.sysnet.pe.kr/3/0/5734

그러고 보니, 제가 COM 개체를 가정하고 C# to C++ 배열 전달은 설명한 적이 있지만,

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

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

순수하게 Win32 DLL API로만 설명한 적이 없어, 이참에 추가해봅니다. ^^




그러니까 결국 질문의 의미는, C#에서 C++ 측으로 배열을 전달하고 싶다는 것입니다. 간단하게 재현 코드를 만들면서 설명해 볼까요?

우선, C/C++ 측의 소스 코드는 다음과 같이 구성할 수 있습니다.

__declspec(dllexport) void __stdcall fnInterop1(unsigned short item[][128])
// 또는, __declspec(dllexport) void __stdcall fnInterop1(unsigned short (*item)[128])
{
    int i = 0;

    for (int x = 0; x < 48; x++) {
        for (int y = 0; y < 128; y++) {
            item[x][y] = ++i;
        }
    }
}

즉, C++ 측은 배열 자체가 48 * 128 크기를 요구하고 있으며 그 안에 값을 설정하는 유형입니다. 이에 따라 호출자(아래에서 설명할 C#) 측은 그에 해당하는 배열을 포인터로 전달하면 됩니다.

using System.Diagnostics;
using System.Runtime.InteropServices;

namespace ConsoleApp1
{
    internal class Program
    {
        [DllImport("Dll1.dll", CallingConvention = CallingConvention.StdCall)]
        public static extern void fnInterop1(IntPtr ptr);

        static unsafe void Main(string[] args)
        {
            ushort[,] data = new ushort[48, 128];
            fixed (ushort* dataPtr = data)
            {
                IntPtr ptr = new IntPtr(dataPtr);
                fnInterop1(ptr);

                int i = 0;

                for (int x = 0; x < 48; x++)
                {
                    for (int y = 0; y < 128; y++)
                    {
                        Debug.Assert(data[x, y] == ++i);
                    }
                }
            }
        }
    }
}

간단하죠? ^^ 또한, 배열이란 원래 연속된 메모리 공간이기 때문에 C#에서 넘겨줄 배열의 차원을 크기만 같다면 다음과 같은 식으로 넘겨줘도 무방합니다.

ushort[,] data = new ushort[2, 3072]; // 2 * 3072 == 6144
// ushort[,] data = new ushort[48, 128]; // 48 * 128 == 6144

물론, 포인터를 직접 넘겨줄 필요는 없습니다. 닷넷 런타임의 Inteop marshaler가 이해할 수 있는 배열이라면 그냥 이렇게 호출해도 무방합니다.

[DllImport("Dll1.dll", CallingConvention = CallingConvention.StdCall)]
public static extern void fnInterop1(ushort[,] data);

var data = new ushort[48, 128];
fnInterop1(data);

닷넷 런타임은 전달된 배열의 크기가 48 * 128의 2차원 배열임을 인지하고 그 크기에 맞춰 마샬링해 C/C++ DLL 측에 넘겨줍니다. 당연히 C/C++ 측에서는 그 메모리에 접근해 값을 쓰면 되고, 다시 그 메모리를 닷넷 런타임은 받아 C# 호출 측에 넘겨줍니다.




참고로, 질문 글에서는 ref로도 배열을 넘겨주는 시도를 했다고 하는데요, 이런 연산은 managed <-> native 연동에서 말이 안 되는 호출입니다.

이미 알고 계시는 것처럼, ref는 피호출자에서 값 자체를 새롭게 할당해 넘겨줄 수 있는 연산입니다. 그런데 그것이 배열이라면 어떻게 될까요? 배열은 닷넷 세계에서 "참조" 개체로 GC Heap에 할당됩니다. 반면 Native 측에서는 GC Heap의 존재를 모르고 단순히 C/C++ 런타임 함수가 제공하는 new/malloc으로 할당한 메모리로 치환할 수 있으므로 GC 입장에서는 치명적인 오류가 발생할 수밖에 없습니다.

관련해서 테스트를 해볼까요? 다음과 같이 호출할 수 있는 C++ 함수를 마련하고,

__declspec(dllexport) void __stdcall fnRefInterop1(unsigned short **refItem)
{
    unsigned short *item = *refItem;
    item[0] = 0xA1;
    item[1] = 0xA2; // C#에서 ref 배열로 전달했다면 1번째 요소 이후로는 값을 설정해도 반영이 안 됨!
}

이렇게 C#으로 호출하면,

[DllImport("Dll1.dll", CallingConvention = CallingConvention.StdCall)]
public static unsafe extern void fnRefInterop1(ref ushort[,] data);

var data = new ushort[48, 128];
// 호출 전에는 data의 타입이 "ushort[48, 128]"이지만,
fnRefInterop1(ref data); // 호출 후에는 ushort[1]로 변경됨

// 요소 1개를 가진 1차원 배열
ushort? elem0 = (ushort?)data.GetValue(0);
Debug.Assert(elem0 == 0xa1);
Debug.Assert(data.GetLength(0) == 1);
Debug.Assert(data.Rank == 1);

배열을 그냥 안전(?)하게 하나의 값만 담은 1차원 배열로 바꿔서 이후 타입을 처리합니다.

이것은 어찌 보면 당연한 결과입니다. [IN]으로 들어가는 C# 측의 배열은 Interop marshaller가 그 크기를 알 수 있어 C/C++ 측에 메모리를 복사해 전달할 수 있지만, C/C++ 내부에서 새롭게 할당돼 (위의 예제에서는 할당하지 않았지만) 나온 배열은 그 크기를 알 수 없기 때문에 Interop marshaller는 그냥 크기가 1인 1차원 배열로 반환해 버리는 것입니다.

여기서 한 가지 재미있는 점은, Interop marshaller는 1차원 배열에 대해서는 ref를 허용하는 우회 방법을 제공한다는 점입니다. 그리고 이때 메모리 할당/해제에 대해서는 C/C++ 런타임에 의존적인 new/malloc 대신 CoTaskMemAlloc/CoTaskMemFree를 사용해야 하며 그 크기를 interop marhsaller가 알 수 있도록 별도의 parameter를 설정해야 합니다. 역시 소스 코드를 통해 알아볼까요? ^^

우선, C/C++ 측은 이렇게 만들 수 있습니다.

__declspec(dllexport) void __stdcall fnRefArrayDim1(unsigned short** refItem, int* pSize)
{
    // ...호출 측에서 refItem에 설정한 데이터를 사용해야 한다면, 여기서 접근...

    // C# 측에서 전달한 refItem을 모두 사용했다면 해제
    // 왜냐하면 C#의 배열은 interop marshaller가 CoTaskMemAlloc으로 할당한 메모리에 복사해 전달해 주므로!
    CoTaskMemFree(*refItem);

    int i = 0;
    *pSize = 48 * 100; // 호출 측으로 전달될 refItem 배열의 크기를 명시

    unsigned short* newArray = (unsigned short*)CoTaskMemAlloc(sizeof(unsigned short) * *pSize);
    if (newArray == nullptr)
    {
        return;
    }

    for (int x = 0; x < *pSize; x++) {
        newArray[x] = ++i;
    }

    *refItem = newArray; // 이후, interop marshaller는 *pSize 만큼의 크기에 해당하는 배열을 GC Heap에 할당하고,
                         // *refItem에 전달된 배열의 값을 모두 복사한 후 CoTaskMemFree로 메모리를 해제
                         // 따라서 C#은 GC Heap에 복사된 메모리를 ref 인자로 받게 됨
}

그리고 C#은 이런 식으로 [IN, OUT], 즉 ref 배열을 C++와 연동할 수 있습니다.

[DllImport("Dll1.dll", CallingConvention = CallingConvention.StdCall)]
public static unsafe extern void fnRefArrayDim1(
    [In, Out, MarshalAs(UnmanagedType.LPArray, ArraySubType = UnmanagedType.U2, SizeParamIndex = 1)] ref ushort[] data, ref int length);

int length = 48 * 128;
var data = new ushort[length];
{
    fnRefArrayDim1(ref data, ref length); // 호출 전에는 48 * 128 크기의 배열이었지만,
                                          // 호출 후에는 48 * 100 크기의 배열로 바뀜

    int i = 0;

    for (int x = 0; x < length; x++)
    {
        Debug.Assert(data[x] == ++i);
    }
}

위와 같이 SizeParamIndex를 지정하면, 이제 닷넷 런타임의 interop marshaller는 해당 "index"의 parameter로 전달된 매개변수, 위에서는 length에 설정한 값이 배열의 크기임을 알 수 있고 정확히 그에 해당하는 크기로 복사 처리를 해줍니다.




위의 경우 1차원 배열을 대상으로 예제를 작성했는데요, 그럼 2차원 배열을 ref로 보내는 것은 어떨까요? 아쉽게도 interop marshaller는 2차원 이상의 배열부터는 지원하지 않습니다.

이것은 MarshalAs의 속성으로도 짐작할 수 있는데요, UnmanagedType.LPArray에는 차원 구분이 없고 SizeParamIndex도 하나입니다. 즉, 2차원 이상의 배열에 대한 크기를 지정할 수 있는 방법이 없습니다. 따라서, 2차원 이상의 배열은 C++ 측에 (이 글의 예제에서 보인 fnInterop1 코드처럼) [IN] 형식으로만 전달할 수 있고 [OUT]으로는 전달받을 수 없습니다. 물론, 배열이 연속적인 메모리 공간임을 감안하면 C++ 측에서 2차원 크기만큼의 배열을 CoTaskMemAlloc으로 할당해 반환하는 것도 가능은 한데요, 하지만 결국 C# 데이터 타입에서의 변환이 불가능하므로 어차피 C#에서도 1차원 배열로 받을 수밖에 없습니다.

관련해서 좀 더 자세한 정보를 얻고 싶다면 다음의 글을 참고하세요.

Marshalling Data with Platform Invoke
; https://learn.microsoft.com/en-us/dotnet/framework/interop/marshalling-data-with-platform-invoke




ref 이야기가 나와서 글이 다소 길어졌는데요, ^^; 정리해 보면, 해당 질문에서는 정상적으로 코드를 작성한 것입니다. 즉, 배열을 가리키는 포인터를 전달했고, C++ DLL 측에서도 제대로 받았을 것입니다. 단지 DLL 함수 호출 이후 값이 변하지 않은 것은, 별개의 문제로 봐야 합니다.

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




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 10/17/2022]

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)
13237정성태1/30/20234409.NET Framework: 2091. C# - 웹 사이트가 어떤 버전의 TLS/SSL을 지원하는지 확인하는 방법
13236정성태1/29/20234165개발 환경 구성: 663. openssl을 이용해 인트라넷 IIS 사이트의 SSL 인증서 생성
13235정성태1/29/20233766개발 환경 구성: 662. openssl - 윈도우 환경의 명령행에서 SAN 적용하는 방법
13234정성태1/28/20234706개발 환경 구성: 661. dnSpy를 이용해 소스 코드가 없는 .NET 어셈블리의 코드를 변경하는 방법 [1]
13233정성태1/28/20235939오류 유형: 840. C# - WebClient로 https 호출 시 "The request was aborted: Could not create SSL/TLS secure channel" 예외 발생
13232정성태1/27/20234025스크립트: 43. uwsgi의 --processes와 --threads 옵션
13231정성태1/27/20233021오류 유형: 839. python - TypeError: '...' object is not callable
13230정성태1/26/20233318개발 환경 구성: 660. WSL 2 내부로부터 호스트 측의 네트워크로 UDP 데이터가 1개의 패킷으로만 제한되는 문제
13229정성태1/25/20234162.NET Framework: 2090. C# - UDP Datagram의 최대 크기
13228정성태1/24/20234299.NET Framework: 2089. C# - WMI 논리 디스크가 속한 물리 디스크의 정보를 얻는 방법 [2]파일 다운로드1
13227정성태1/23/20234023개발 환경 구성: 659. Windows - IP MTU 값을 바꿀 수 있을까요? [1]
13226정성태1/23/20233702.NET Framework: 2088. .NET 5부터 지원하는 GetRawSocketOption 사용 시 주의할 점
13225정성태1/21/20233067개발 환경 구성: 658. Windows에서 실행 중인 소켓 서버를 다른 PC 또는 WSL에서 접속할 수 없는 경우
13224정성태1/21/20233352Windows: 221. Windows - Private/Public/Domain이 아닌 네트워크 어댑터 단위로 방화벽을 on/off하는 방법
13223정성태1/20/20233582오류 유형: 838. RDP 연결 오류 - The two computers couldn't connect in the amount of time allotted
13222정성태1/20/20233283개발 환경 구성: 657. WSL - DockerDesktop.vhdx 파일 위치를 옮기는 방법
13221정성태1/19/20233529Linux: 57. C# - 리눅스 프로세스 메모리 정보파일 다운로드1
13220정성태1/19/20233634오류 유형: 837. NETSDK1045 The current .NET SDK does not support targeting .NET ...
13219정성태1/18/20233154Windows: 220. 네트워크의 인터넷 접속 가능 여부에 대한 판단 기준
13218정성태1/17/20233102VS.NET IDE: 178. Visual Studio 17.5 (Preview 2) - 포트 터널링을 이용한 웹 응용 프로그램의 외부 접근 허용
13217정성태1/13/20233657디버깅 기술: 185. windbg - 64비트 운영체제에서 작업 관리자로 뜬 32비트 프로세스의 덤프를 sos로 디버깅하는 방법
13216정성태1/12/20233935디버깅 기술: 184. windbg - 32비트 프로세스의 메모리 덤프인 경우 !peb 명령어로 나타나지 않는 환경 변수
13215정성태1/11/20235226Linux: 56. 리눅스 - /proc/pid/stat 정보를 이용해 프로세스의 CPU 사용량 구하는 방법 [1]
13214정성태1/10/20235050.NET Framework: 2087. .NET 6부터 SourceGenerator와 통합된 System.Text.Json [1]파일 다운로드1
13213정성태1/9/20234525오류 유형: 836. docker 이미지 빌드 시 "RUN apt install ..." 명령어가 실패하는 이유
13212정성태1/8/20234301기타: 85. 단정도/배정도 부동 소수점의 정밀도(Precision)에 따른 형변환 손실
1  2  3  4  5  6  7  8  9  10  11  12  13  [14]  15  ...