성태의 닷넷 이야기
홈 주인
모아 놓은 자료
프로그래밍
질문/답변
사용자 관리
사용자
메뉴
아티클
외부 아티클
유용한 코드
온라인 기능
MathJax 입력기
최근 덧글
[정성태] Working with Rust Libraries from C#...
[정성태] Detecting blocking calls using asyn...
[정성태] 아쉽게도, 커뮤니티는 아니고 개인 블로그입니다. ^^
[정성태] 질문이 잘 이해가 안 됩니다. 우선, 해당 소스코드에서 ILis...
[양승조
] var대신 dinamic으로 선언해서 해결은 했습니다. 맞는 해...
[양승조
] 또 막혔습니다. ㅠㅠ var list = props[i].Ge...
[양승조
] 아. 감사합니다. 어제는 안됐던것 같은데....정신을 차려야겠네...
[정성태] "props[i].GetValue(props[i])" 코드에서 ...
[정성태] 저렇게 조각 코드 말고, 실제로 재현이 되는 예제 프로젝트를 압...
[정성태] Modules 창(Ctrl+Shift+U)을 띄워서, 해당 Op...
글쓰기
제목
이름
암호
전자우편
HTML
홈페이지
유형
제니퍼 .NET
닷넷
COM 개체 관련
스크립트
VC++
VS.NET IDE
Windows
Team Foundation Server
디버깅 기술
오류 유형
개발 환경 구성
웹
기타
Linux
Java
DDK
Math
Phone
Graphics
사물인터넷
부모글 보이기/감추기
내용
<div style='display: inline'> <h1 style='font-family: Malgun Gothic, Consolas; font-size: 20pt; color: #006699; text-align: center; font-weight: bold'>.NET Framework 및 .NET 5 - UnmanagedCallersOnly 특성 사용</h1> <p> UnmanagedCallersOnly 특성은,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > UnmanagedCallersOnlyAttribute Class ; <a target='tab' href='https://learn.microsoft.com/en-us/dotnet/api/system.runtime.interopservices.unmanagedcallersonlyattribute'>https://learn.microsoft.com/en-us/dotnet/api/system.runtime.interopservices.unmanagedcallersonlyattribute</a> Improvements in native code interop in .NET 5.0 ; <a target='tab' href='https://devblogs.microsoft.com/dotnet/improvements-in-native-code-interop-in-net-5-0/'>https://devblogs.microsoft.com/dotnet/improvements-in-native-code-interop-in-net-5-0/</a> </pre> <br /> 관리 코드를 native에서 접근하기 위한 다양한 방법에 사용됩니다. 대표적으로 C# 9.0에서도 function pointer와 함께 native 측으로 런타임에 닷넷 함수를 노출할 때도 사용할 수 있습니다. 따라서 이 기능으로만 제한한다면 UnmanagedCallersOnly 특성은 (단지 C# 9.0 컴파일러로 빌드할 수 있다면) 모든 플랫폼에서 사용하는 것이 가능합니다.<br /> <br /> <hr style='width: 50%' /><br /> <br /> 사용 예제를 들어가기에 앞서 기존 문제점을 먼저 짚어 보겠습니다. 가령, 윈도우 운영체제에 실행 중인 윈도우(Window)를 열거할 때 EnumWindows Win32 API로,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > EnumWindows function (winuser.h) ; <a target='tab' href='https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-enumwindows'>https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-enumwindows</a> </pre> <br /> 다음과 같이 callback을 받아 사용할 수 있습니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > using PInvoke; using System; using System.Windows.Forms; namespace WindowsFormsApp1 { // dotnet / pinvoke // <a target='tab' href='https://github.com/dotnet/pinvoke'>https://github.com/dotnet/pinvoke</a> <span style='color: blue; font-weight: bold'>// Install-Package PInvoke.User32</span> public partial class Form1 : Form { public Form1() { InitializeComponent(); } <span style='color: blue; font-weight: bold'>static bool ewCallback(IntPtr hwnd, IntPtr userContext)</span> { string title = ""; try { title = User32.GetWindowText(hwnd); if (string.IsNullOrEmpty(title) == true) { return true; } } catch (System.ComponentModel.Win32Exception) { return true; } System.Diagnostics.Trace.WriteLine($"{title}: {hwnd}"); return true; } private void Form1_Load(object sender, EventArgs e) { <span style='color: blue; font-weight: bold'>User32.EnumWindows(ewCallback, IntPtr.Zero);</span> // 위의 코드는 결국 이렇게 호출한 것과 동일 // User32.WNDENUMPROC lpEnumProc = new User32.WNDENUMPROC(ewCallback); // User32.EnumWindows(lpEnumProc, IntPtr.Zero); } } } </pre> <br /> 그러니까, (위의 경우 WNDENUMPROC) Delegate 타입의 인스턴스에 닷넷 메서드를 포장해 전달하고 있습니다. 대개의 경우, 이번 EnumWindows처럼 해당 호출의 내부 실행 중에 콜백이 전부 발생한다면 문제가 발생할 여지는 없습니다. 하지만, 간혹 비동기적으로 콜백을 호출하는... 예를 들어 SetTimer와 같은 경우는,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > SetTimer function (winuser.h) ; <a target='tab' href='https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-settimer'>https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-settimer</a> </pre> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > using System; using System.Runtime.InteropServices; using System.Windows.Forms; namespace WindowsFormsApp1 { public partial class Form1 : Form { [DllImport("user32.dll", ExactSpelling = true)] static extern IntPtr SetTimer(IntPtr hWnd, IntPtr nIDEvent, uint uElapse, TimerProc lpTimerFunc); delegate void TimerProc(IntPtr hWnd, uint uMsg, IntPtr nIDEvent, uint dwTime); public Form1() { InitializeComponent(); } <span style='color: blue; font-weight: bold'>static void timerCallback(IntPtr hWnd, uint uMsg, IntPtr nIDEvent, uint dwTime) { Console.WriteLine($"timerCallback - {dwTime}"); }</span> private void Form1_Load(object sender, EventArgs e) { SetTimer(this.Handle, IntPtr.Zero, 1000, timerCallback); // 위의 코드는 결국 이렇게 호출한 것과 동일 // TimerProc timerProc = new TimerProc(timerCallback); // SetTimer(this.Handle, IntPtr.Zero, 1000, timerProc); } } } </pre> <br /> 호출 이후, 초기에는 1초 간격으로 timerCallback이 잘 동작하지만 어느 순간부터, 디버깅 중이라면 비주얼 스튜디오에서 이런 오류 창을 보여줄 것이고,<br /> <br /> <div style='BACKGROUND-COLOR: #ccffcc; padding: 10px 10px 5px 10px; MARGIN: 0px 10px 10px 10px; FONT-FAMILY: Malgun Gothic, Consolas, Verdana; COLOR: #005555'> Managed Debugging Assistant 'CallbackOnCollectedDelegate' <br /> Message=Managed Debugging Assistant 'CallbackOnCollectedDelegate' : 'A callback was made on a garbage collected delegate of type 'WindowsFormsApp1!WindowsFormsApp1.Form1+TimerProc::Invoke'. This may cause application crashes, corruption and data loss. When passing delegates to unmanaged code, they must be kept alive by the managed application until it is guaranteed that they will never be called.'<br /> </div><br /> <br /> 그렇지 않다면, 비정상 종료하면서 이벤트 로그에 그 기록이 남을 것입니다. 관련해서는 이전에도 여러 번 글을 쓴 적이 있습니다. ^^<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > CallbackOnCollectedDelegate was detected ; <a target='tab' href='https://www.sysnet.pe.kr/2/0/710'>https://www.sysnet.pe.kr/2/0/710</a> C#에서 C/C++ 함수로 콜백 함수를 전달하는 예제 코드 ; <a target='tab' href='https://www.sysnet.pe.kr/2/0/11099'>https://www.sysnet.pe.kr/2/0/11099</a> OpenGL.NET 예제 실행 시 "Managed Debugging Assistant 'CallbackOnCollectedDelegate'" 예외 발생 ; <a target='tab' href='https://www.sysnet.pe.kr/2/0/11786'>https://www.sysnet.pe.kr/2/0/11786</a> </pre> <br /> <hr style='width: 50%' /><br /> <a name='fptr'></a> <br /> 이런 문제를, 게다가 더욱 쉬운 방법으로 해결할 수 있는 것이 바로 <a target='tab' href='https://www.sysnet.pe.kr/2/0/12374'>C# 9.0의 function pointer</a>와 UnmanagedCallersOnly 특성의 조합입니다. 위의 예제와 같은 경우라면 콜백 메서드에 UnmanagedCallersOnly 특성과 함께 함수 포인터를 받도록 pinvoke를 마련하고,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > [DllImport("user32.dll", ExactSpelling = true)] static unsafe extern IntPtr SetTimer(IntPtr hWnd, IntPtr nIDEvent, uint uElapse, <span style='color: blue; font-weight: bold'>delegate* unmanaged[Stdcall]<IntPtr, uint, IntPtr, uint, void> lpTimerFunc</span>); <span style='color: blue; font-weight: bold'>[UnmanagedCallersOnly(CallConvs = new Type[] { typeof(CallConvStdcall) })]</span> static void timerCallback(IntPtr hWnd, uint uMsg, IntPtr nIDEvent, uint dwTime) { Console.WriteLine($@"{(IntPtr.Size == 4 ? "x86" : "x64")}: {DateTime.Now}"); } </pre> <br /> 이렇게 바로 SetTimer를 호출하면 됩니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > SetTimer(this.Handle, IntPtr.Zero, 1000, &timerCallback); </pre> <br /> 이 방법은 <a target='tab' href='https://www.sysnet.pe.kr/2/0/12409'>함수의 위치를 가리키는 포인터 주솟값</a>을 곧바로 native 측에 전달하는 것이기 때문에, 기존에 Delegate 개체가 GC되었을 때 오동작하게 되는 문제에서 자연스럽게 벗어납니다.<br /> <br /> 그야말로... 성능도 좋고, 구문도 간단해지고, GC 문제도 없어지니 안 쓸 이유가 없지만 한 가지 유의할 사항이 있습니다. UnmanagedCallersOnly 특성이 부여된 메서드는 분명히 "unmanaged" 환경이라는 것을 알아야 합니다. 이런 영향 때문에, 메서드의 인자로 전달할 수 있는 타입은 <a target='tab' href='https://www.sysnet.pe.kr/2/0/11557'>blittable 유형</a>만 가능하며, (Delegate로 경유했을 때는 "managed" 환경이므로 콜백 메서드를 인스턴스 멤버로 정의해 내부에서 "this"를 사용하는 것도 가능하지만) 반드시 static 메서드로 정의해야 한다는 차이점도 발생합니다.<br /> <br /> 또한 닷넷 코드에서 직접 UnmanagedCallersOnly가 적용된 메서드를 호출하면 이런 오류가 발생합니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > private void button1_Click(object sender, EventArgs e) { // 컴파일 오류 - Error CS8901 'Form1.timerCallback(IntPtr, uint, IntPtr, uint)' is attributed with 'UnmanagedCallersOnly' and cannot be called directly. Obtain a function pointer to this method. timerCallback(this.Handle, 0, IntPtr.Zero, 0); } </pre> <br /> 메시지에도 나오듯이, 직접 호출은 할 수 없지만 대신 함수 포인터를 이용하면 닷넷에서도 호출이 가능합니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > private unsafe void button1_Click(object sender, EventArgs e) { // timerCallback(this.Handle, 0, IntPtr.Zero, 0); <span style='color: blue; font-weight: bold'>delegate* unmanaged[Stdcall]<IntPtr, uint, IntPtr, uint, void> lpTimerFunc = &timerCallback;</span> lpTimerFunc(this.Handle, 0, IntPtr.Zero, 0); } </pre> <br /> (<a target='tab' href='https://www.sysnet.pe.kr/bbs/DownloadAttachment.aspx?fid=1657&boardid=331301885'>첨부 파일은 이 글의 예제 코드를 포함</a>합니다.)<br /> <br /> <hr style='width: 50%' /><br /> <br /> 참고로, UnmanagedCallersOnly 특성은 .NET 5의 BCL에만 있으므로, NET Framework에서는 다음과 같이 그냥 클래스만 정의해 포함하면 됩니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > #if !NET5_0 namespace System.Runtime.InteropServices { [AttributeUsage(AttributeTargets.Method, Inherited = false)] public sealed class UnmanagedCallersOnlyAttribute : Attribute { public Type[] CallConvs; public string EntryPoint; } } #endif </pre> </p><br /> <br /><hr /><span style='color: Maroon'>[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]</span> </div>
첨부파일
스팸 방지용 인증 번호
2904
(왼쪽의 숫자를 입력해야 합니다.)