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

C# - CLR ThreadPool의 I/O 스레드에 작업을 맡기는 방법

답 먼저 이야기하면, ThreadPool에서 제공하는 RegisterWaitForSingleObject 정적 메서드를 이용하면 됩니다.

RegisterWaitForSingleObject function (winbase.h)
; https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-registerwaitforsingleobject

ThreadPool.RegisterWaitForSingleObject Method
; https://learn.microsoft.com/en-us/dotnet/api/system.threading.threadpool.registerwaitforsingleobject

ThreadPool.RegisterWaitForSingleObject의 경우 인자로 WaitHandle을 받아들이는데요, 따라서 그것을 상속한 System.Threading.EventWaitHandle, System.Threading.Mutex, System.Threading.Semaphore 개체와 연동할 수 있습니다.

예를 들어 볼까요?

EventWaitHandle을 이용해 작업을 추가하고, 별도로 생성한 스레드에서 그 이벤트를 대기해 처리하는 코드를 다음과 같이 만들 수 있습니다. (전형적인 Producer/Consumer 모델입니다.)

using System;
using System.Collections.Concurrent;
using System.Runtime.Versioning;

[assembly: SupportedOSPlatform("windows")]

internal class Program
{
    static EventWaitHandle _signal = new EventWaitHandle(false, EventResetMode.AutoReset);
    static ConcurrentQueue<string> _works = new ConcurrentQueue<string>();

    static void Main(string[] args)
    {
        Thread t = new Thread(consumerFunc);
        t.Start();

        while (true)
        {
            string? text = Console.ReadLine();
            if (string.IsNullOrEmpty(text))
            {
                break;
            }

            _works.Enqueue(text);
            _signal.Set();
        }
    }

    private static void doWork(string text)
    {
        Console.WriteLine($"echo: {text}");
    }

    private static void consumerFunc(object? obj)
    {
        while (true)
        {
            _signal.WaitOne();

            if (_works.TryDequeue(out var text) == true)
            {
                doWork(text);
            }
        }
    }
}

위의 코드를 보면, "Consumer" 역할을 위해 별도의 스레드를 생성했는데요, 사실 스레드를 하나 별도로 유지하는 게 은근히 귀찮은 작업입니다. (혹은 다중 스레드로 consumer 역할을 하는 경우까지 생각하면 더더욱 귀찮습니다. ^^;) 기왕이면, 기본적으로 활성화되어 있는 CLR ThreadPool에 작업을 맡기는 것도 좋을 텐데요, 바로 이런 처리를 ThreadPool.RegisterWaitForSingleObject로 할 수 있습니다.

실제로, 아래의 소스 코드는 ThreadPool.RegisterWaitForSingleObject를 이용해 동일한 기능을 구현한 것입니다.

using System.Collections.Concurrent;
using System.Runtime.Versioning;

[assembly: SupportedOSPlatform("windows")]

internal class Program
{
    static EventWaitHandle _signal = new EventWaitHandle(false, EventResetMode.AutoReset);
    static ConcurrentQueue<string> _works = new ConcurrentQueue<string>();

    static void Main(string[] args)
    {
        RegisteredWaitHandle rwh = ThreadPool.RegisterWaitForSingleObject(_signal, doWork, null, -1, false);

        while (true)
        {
            string? text = Console.ReadLine();
            if (string.IsNullOrEmpty(text))
            {
                break;
            }

            _works.Enqueue(text);
            _signal.Set();
        }

        rwh.Unregister(_signal);
    }

    private static void doWork(object? state, bool timedOut)
    {
        if (_works.TryDequeue(out var text) == true)
        {
            Console.WriteLine($"echo: {text}");
        }
    }
}

좀 더 간결해졌죠? ^^ 게다가 아래의 글에서는,

AutoReset, ManualReset, Monitor.Wait의 차이
; https://www.sysnet.pe.kr/2/0/1015#4

Consumer 역할의 스레드 제거를 우아하게 하기 위해 ManualReset 이벤트까지 활용했어야 하는데 ThreadPool.RegisterWaitForSingleObject를 이용하면 그것마저도 필요가 없습니다. (어찌 보면, BlockingCollection<T>을 이용하는 것보다 더 쉽습니다.)




해본 김에, 적당한 활용 사례를 하나 더 들어볼까요? 예전에 썼던 글이 하나 떠오르는데요,

PInvoke 호출을 이용한 비동기 파일 작업
; https://www.sysnet.pe.kr/2/0/1750

위의 코드는 C#의 FileStream.WriteAsync를 Win32 API를 이용해 직접 구현한 것입니다. 하지만 아쉽게도 비동기 동작으로 WriteFile API는 호출했지만, WaitHandle.WaitAny를 이용해 대기함으로써 사실상 처리는 동기 방식과 다를 바가 없었습니다.

이것을 ThreadPool.RegisterWaitForSingleObject을 이용해 처리하면 BCL의 WriteAsync 메서드와 유사하게 동작을 흉내 낼 수 있습니다.

using Microsoft.Win32.SafeHandles;
using System.Diagnostics.CodeAnalysis;
using System.Runtime.InteropServices;
using System.Runtime.Versioning;
using System.Text;

[assembly: SupportedOSPlatform("windows")]

class Program
{
    [DllImport("kernel32.dll", SetLastError = true)]
    public static extern SafeFileHandle CreateFile(
       String pipeName,
       uint dwDesiredAccess,
       uint dwShareMode,
       IntPtr lpSecurityAttributes,
       uint dwCreationDisposition,
       uint dwFlagsAndAttributes,
       IntPtr hTemplate);

    [DllImport("kernel32.dll", SetLastError = true)]
    static extern bool WriteFile(SafeFileHandle hFile, byte[] lpBuffer,
       int nNumberOfBytesToWrite, out uint lpNumberOfBytesWritten,
       [In] ref System.Threading.NativeOverlapped lpOverlapped);

    public const int FILE_FLAG_OVERLAPPED = 0x40000000;

    static void Main(string[] args)
    {
        string txt = new string('t', 1024 * 1024 * 600);
        byte[] buf = Encoding.ASCII.GetBytes(txt);

        File.Delete(@"C:\temp\test.txt");

        using (SafeFileHandle pHandle = CreateFile(@"c:\temp\test.txt",
                (uint)FileAccess.ReadWrite,
                0,
                IntPtr.Zero,
                (uint)2,
                FILE_FLAG_OVERLAPPED,
                IntPtr.Zero))
        {
            uint written;
            NativeOverlapped o = new NativeOverlapped();

            EventWaitHandle writeEvent = new EventWaitHandle(false, EventResetMode.AutoReset);
            o.EventHandle = writeEvent.SafeWaitHandle.DangerousGetHandle();

            if (WriteFile(pHandle, buf, buf.Length, out written, ref o) == false)
            {
                int lastError = Marshal.GetLastWin32Error();
                if (lastError == 997) //  ERROR_IO_PENDING == 997
                {
                    OverlappedParameter op = new OverlappedParameter()
                    {
                        Event = writeEvent,
                    };

                    op.WaitHandle = ThreadPool.RegisterWaitForSingleObject(writeEvent, WriteCompleted, op, -1, false);
                    op.TryUnregister();
                }
                else
                {
                    // Write File Error
                    Console.WriteLine("Write File Error");
                    writeEvent.Close();
                }
            }
        }

        Console.WriteLine("Press Enter to exit ...");
        Console.ReadLine();
    }

    public static void WriteCompleted(object? objState, bool timedOut)
    {
        OverlappedParameter? op = objState as OverlappedParameter;
        if (op == null)
        {
            return;
        }

        Console.WriteLine("async WriteCompleted");
        op.Done();
    }
}

public class OverlappedParameter
{
    [AllowNull]
    public EventWaitHandle Event { get; set; } = null;

    [AllowNull]
    public RegisteredWaitHandle WaitHandle { get; set; } = null;

    bool _done;
    bool _disposed;

    public void Done()
    {
        _done = true;
        TryUnregister();
    }

    public void TryUnregister()
    {
        if (_done == false)
        {
            return;
        }

        lock (Event)
        {
            if (_disposed == true)
            {
                return;
            }

            _disposed = true;

            WaitHandle.Unregister(Event);
            Event.Dispose();
        }
    }
}

오~~~ 좀 그럴 듯하게 바뀌었습니다. ^^




그나저나, ThreadPool.RegisterWaitForSingleObject로 인해 콜백을 호출하는 스레드는 Worker일까요? I/O일까요? ThreadPool.SetMaxThreads를 이용해 간단하게 테스트해 보면 됩니다. ^^

C# - ThreadPool.SetMaxThreads 사용법
; https://www.sysnet.pe.kr/2/0/13058

각각 다음과 같은 2가지 경우로 실행해 보면 될 텐데요,

// Worker 스레드 수를 최대 1개로 변경
ThreadPool.SetMinThreads(1, 4);
ThreadPool.SetMaxThreads(1, 4);

// I/O 스레드 수를 최대 1개로 변경
ThreadPool.SetMinThreads(4, 1);
ThreadPool.SetMaxThreads(4, 1);

위와 같은 설정 상태에서 WriteAsync를 2번 연이어 호출하고 콜백 메서드에서는 의도적으로 5초 정도 지연하면 결과를 금방 확인할 수 있습니다.

static void Main(string[] args)
{
    ThreadPool.SetMinThreads(...[스레드 제약]...);
    ThreadPool.SetMaxThreads(...[스레드 제약]...);

    // ...[생략]...
    WriteAsync(pHandle, buf); // RegisterWaitForSingleObject 호출을 이용한 비동기 파일 Write를 담고 있는 메서드 
    WriteAsync(pHandle, buf);

    // ...[생략]...
    Console.WriteLine("Press Enter to exit ...");
    Console.ReadLine();
}

public static void WriteCompleted(object? objState, bool timedOut)
{
    Console.WriteLine($"{DateTime.Now} async WriteCompleted");

    Thread.Sleep(1000 * 5);

    // ...[생략]...
}

우선, Worker 스레드를 1개로 제한했을 때는 이런 식으로 출력이 되었고,

2022-05-14 오전 12:25:42 async WriteCompleted
Press Enter to exit ...
2022-05-14 오전 12:25:42 async WriteCompleted

I/O 스레드를 1개로 제한했을 때는 이런 식으로 출력이 되었습니다.

2022-05-14 오전 12:26:01 async WriteCompleted
Press Enter to exit ...
2022-05-14 오전 12:27:06 async WriteCompleted

즉, ThreadPool.RegisterWaitForSingleObject로 인한 콜백은 I/O 스레드에서 호출되는 것입니다. 그렇다면, 다음과 같이 ThreadPool의 사용법이 정리가 됩니다.

[Worker 스레드에 작업을 할당] ThreadPool.QueueUserWorkItem
[I/O 스레드에 작업을 할당] ThreadPool.RegisterWaitForSingleObject

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




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 11/4/2022]

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

비밀번호

댓글 작성자
 



2023-02-16 09시53분
What are the potentially-erroneous results if you don’t pass NULL as the lpNumberOfBytesRead when issuing overlapped I/O?
; https://devblogs.microsoft.com/oldnewthing/20230215-00/?p=107832

overlapped I/O 수행 시 굳이 lpNumber­Of­Bytes­Read 인자에 값을 넣을 필요는 필요는 없다고 합니다. 심지어, 자칫 Get­Overlapped­Result에 같은 변수가 사용되면 부작용까지 발생할 수 있습니다. 그래서 차라리 문서에서는 복잡한 설명을 추가하기보다는 그냥 lpNumber­Of­Bytes­Read에 null을 전달하라는 식으로 써졌다고 하는데요. ^^

그래도 lpNumber­Of­Bytes­Read 인자가 의미가 있을 때도 있다고 합니다. FILE_SKIP_COMPLETION_PORT_ON_SUCCESS 옵션으로 I/O를 수행 시에는 읽어낸 바이트 수를 알아내기 위해 별도로 Get­Overlapped­Result를 호출해야 하지만 그것 없이 lpNumber­Of­Bytes­Read 인자를 전달하면 성능상 micro-optimization 수준에서 의미가 있다고.
정성태

... 31  32  33  34  35  36  37  38  39  40  41  42  43  44  [45]  ...
NoWriterDateCnt.TitleFile(s)
12512정성태1/28/20218673오류 유형: 697. The program can't start because VCRUNTIME140.dll is missing from your computer. Try reinstalling the program to fix this problem.
12511정성태1/27/20218428Windows: 187. Windows - 도스 시절의 8.3 경로를 알아내는 방법
12510정성태1/27/20218796.NET Framework: 1020. .NET Core Kestrel 호스팅 - Razor 지원 추가 [1]파일 다운로드1
12509정성태1/27/20219733개발 환경 구성: 524. Jupyter Notebook에서 C#(F#, PowerShell) 언어 사용을 위한 환경 구성 [3]
12508정성태1/27/20218313개발 환경 구성: 523. Jupyter Notebook - Slide 플레이 버튼이 없는 경우
12507정성태1/26/20218440VS.NET IDE: 157. Visual Studio - Syntax Visualizer 메뉴가 없는 경우
12506정성태1/25/202111752.NET Framework: 1019. Microsoft.Tye 기본 사용법 소개 [1]
12505정성태1/23/20219439.NET Framework: 1018. .NET Core Kestrel 호스팅 - Web API 추가 [1]파일 다운로드1
12504정성태1/23/202110540.NET Framework: 1017. .NET 5에서의 네트워크 라이브러리 개선 (2) - HTTP/2, HTTP/3 관련 [1]
12503정성태1/21/20218866오류 유형: 696. C# - HttpClient: Requesting HTTP version 2.0 with version policy RequestVersionExact while HTTP/2 is not enabled.
12502정성태1/21/20219655.NET Framework: 1016. .NET Core HttpClient의 HTTP/2 지원파일 다운로드1
12501정성태1/21/20218718.NET Framework: 1015. .NET 5부터 HTTP/1.1, 2.0 선택을 위한 HttpVersionPolicy 동작 방식파일 다운로드1
12500정성태1/21/20219283.NET Framework: 1014. ASP.NET Core(Kestrel)의 HTTP/2 지원 여부파일 다운로드1
12499정성태1/20/202110475.NET Framework: 1013. .NET Core Kestrel 호스팅 - 포트 변경, non-localhost 접속 지원 및 https 등의 설정 변경 [1]파일 다운로드1
12498정성태1/20/20219456.NET Framework: 1012. .NET Core Kestrel 호스팅 - 비주얼 스튜디오의 Kestrel/IIS Express 프로파일 설정
12497정성태1/20/202110400.NET Framework: 1011. C# - OWIN Web API 예제 프로젝트 [1]파일 다운로드2
12496정성태1/19/20219240.NET Framework: 1010. .NET Core 콘솔 프로젝트에서 Kestrel 호스팅 방법 [1]
12495정성태1/19/202111246웹: 40. IIS의 HTTP/2 지원 여부 - h2, h2c [1]
12494정성태1/19/202110530개발 환경 구성: 522. WSL2 인스턴스와 호스트 측의 Hyper-V에 운영 중인 VM과 네트워크 연결을 하는 방법 [2]
12493정성태1/18/20218835.NET Framework: 1009. .NET 5에서의 네트워크 라이브러리 개선 (1) - HTTP 관련 [1]파일 다운로드1
12492정성태1/17/20218253오류 유형: 695. ASP.NET 0x80131620 Failed to bind to address
12491정성태1/16/20219908.NET Framework: 1008. 배열을 반환하는 C# COM 개체의 메서드를 C++에서 사용 시 메모리 누수 현상 [1]파일 다운로드1
12490정성태1/15/20219435.NET Framework: 1007. C# - foreach에서 열거 변수의 타입을 var로 쓰면 object로 추론하는 문제 [1]파일 다운로드1
12489정성태1/13/202110360.NET Framework: 1006. C# - DB에 저장한 텍스트의 (이모티콘을 비롯해) 유니코드 문자가 '?'로 보인다면? [1]
12488정성태1/13/202110639.NET Framework: 1005. C# - string 타입은 shallow copy일까요? deep copy일까요? [2]파일 다운로드1
12487정성태1/13/20219114.NET Framework: 1004. C# - GC Heap에 위치한 참조 개체의 주소를 알아내는 방법파일 다운로드1
... 31  32  33  34  35  36  37  38  39  40  41  42  43  44  [45]  ...