DreamineVMS.Services.Streaming.ChildProcessJob 클래스 참조

더 자세히 ...

DreamineVMS.Services.Streaming.ChildProcessJob에 대한 상속 다이어그램 :

DreamineVMS.Services.Streaming.ChildProcessJob에 대한 협력 다이어그램:

클래스
struct	JOBOBJECT_BASIC_LIMIT_INFORMATION
struct	IO_COUNTERS
struct	JOBOBJECT_EXTENDED_LIMIT_INFORMATION

Public 멤버 함수
	ChildProcessJob ()
bool	AddProcess (Process process)
void	Dispose ()

Private 타입
enum	JobObjectInfoType { ExtendedLimitInformation = 9 }

Private 멤버 함수
static IntPtr	CreateJobObject (IntPtr lpJobAttributes, string? lpName)
static bool	SetInformationJobObject (IntPtr hJob, JobObjectInfoType infoType, IntPtr lpJobObjectInfo, uint cbJobObjectInfoLength)
static bool	AssignProcessToJobObject (IntPtr hJob, IntPtr hProcess)
static bool	CloseHandle (IntPtr hObject)

Private 속성
IntPtr	_handle
bool	_disposed

정적 Private 속성
const uint	JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE = 0x00002000

상세한 설명

자식 프로세스를 Windows Job Object에 묶어, 부모 프로세스가 비정상 종료되더라도 자식 프로세스(ffmpeg)가 함께 종료되도록 보장하는 헬퍼입니다.

부모 프로세스가 정상 경로(StopAsync)로 종료되지 못하고 강제 종료될 때, Job Object에 KILL_ON_JOB_CLOSE 플래그가 설정되어 있으면 Job 핸들이 닫히는 순간 OS가 소속 자식 프로세스를 모두 종료합니다. 이를 통해 ffmpeg 고아 프로세스가 남는 문제를 구조적으로 차단합니다.

ChildProcessJob.cs 파일의 25 번째 라인에서 정의되었습니다.

멤버 열거형 문서화

JobObjectInfoType

enum DreamineVMS.Services.Streaming.ChildProcessJob.JobObjectInfoType

private

Job Object Info Type 기능과 관련 상태를 캡슐화합니다.

열거형 멤버
ExtendedLimitInformation	Extended Limit Information 값을 나타냅니다.

ChildProcessJob.cs 파일의 182 번째 라인에서 정의되었습니다.

    {
        ExtendedLimitInformation = 9
    }

생성자 & 소멸자 문서화

ChildProcessJob()

DreamineVMS.Services.Streaming.ChildProcessJob.ChildProcessJob ( )

inline

ChildProcessJob 클래스의 새 인스턴스를 초기화하고 Job Object를 생성합니다.

ChildProcessJob.cs 파일의 54 번째 라인에서 정의되었습니다.

    {
        _handle = CreateJobObject(IntPtr.Zero, null);
        if (_handle == IntPtr.Zero)
        {
            // Job Object를 만들 수 없는 환경(권한 등)에서는 핸들이 0으로 남고,
            // AddProcess는 무시됩니다. 이 경우 기존 동작(개별 Kill)으로 폴백됩니다.
            return;
        }
 
        JOBOBJECT_BASIC_LIMIT_INFORMATION basicLimit = new()
        {
            LimitFlags = JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE
        };
 
        JOBOBJECT_EXTENDED_LIMIT_INFORMATION extendedLimit = new()
        {
            BasicLimitInformation = basicLimit
        };
 
        int length = Marshal.SizeOf<JOBOBJECT_EXTENDED_LIMIT_INFORMATION>();
        IntPtr extendedPtr = Marshal.AllocHGlobal(length);
        try
        {
            Marshal.StructureToPtr(extendedLimit, extendedPtr, false);
 
            if (!SetInformationJobObject(
                    _handle,
                    JobObjectInfoType.ExtendedLimitInformation,
                    extendedPtr,
                    (uint)length))
            {
                CloseHandle(_handle);
                _handle = IntPtr.Zero;
            }
        }
        finally
        {
            Marshal.FreeHGlobal(extendedPtr);
        }
    }

다음을 참조함 : _handle, CloseHandle(), CreateJobObject(), JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE, SetInformationJobObject().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

멤버 함수 문서화

AddProcess()

bool DreamineVMS.Services.Streaming.ChildProcessJob.AddProcess ( Process process )

inline

지정한 프로세스를 Job Object에 추가합니다.

매개변수

process

Job에 묶을 자식 프로세스입니다.

반환값

성공 여부입니다. Job Object를 사용할 수 없는 환경에서는 false를 반환합니다.

ChildProcessJob.cs 파일의 120 번째 라인에서 정의되었습니다.

    {
        ArgumentNullException.ThrowIfNull(process);
 
        if (_handle == IntPtr.Zero || _disposed)
        {
            return false;
        }
 
        try
        {
            return AssignProcessToJobObject(_handle, process.Handle);
        }
        catch (InvalidOperationException)
        {
            // 프로세스가 이미 종료된 경우 등.
            return false;
        }
    }

다음을 참조함 : _disposed, _handle, AssignProcessToJobObject().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

AssignProcessToJobObject()

bool DreamineVMS.Services.Streaming.ChildProcessJob.AssignProcessToJobObject ( IntPtr hJob, IntPtr hProcess )

private

Assign Process To Job Object 작업을 수행합니다.

매개변수

hJob	h Job에 사용할 IntPtr 값입니다.
hProcess	h Process에 사용할 IntPtr 값입니다.

반환값

Assign Process To Job Object 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

다음에 의해서 참조됨 : AddProcess().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

CloseHandle()

bool DreamineVMS.Services.Streaming.ChildProcessJob.CloseHandle ( IntPtr hObject )

private

Close Handle 작업을 수행합니다.

매개변수

hObject

h Object에 사용할 IntPtr 값입니다.

반환값

Close Handle 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

다음에 의해서 참조됨 : ChildProcessJob(), Dispose().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

CreateJobObject()

IntPtr DreamineVMS.Services.Streaming.ChildProcessJob.CreateJobObject ( IntPtr lpJobAttributes, string? lpName )

private

Job Object 값을 생성합니다.

매개변수

lpJobAttributes	lp Job Attributes에 사용할 IntPtr 값입니다.
lpName	lp Name에 사용할 string? 값입니다.

반환값

Create Job Object 작업에서 생성한 IntPtr 결과입니다.

다음에 의해서 참조됨 : ChildProcessJob().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

Dispose()

void DreamineVMS.Services.Streaming.ChildProcessJob.Dispose ( )

inline

Job Object 핸들을 닫습니다. KILL_ON_JOB_CLOSE에 의해 소속된 모든 자식 프로세스가 함께 종료됩니다.

ChildProcessJob.cs 파일의 148 번째 라인에서 정의되었습니다.

    {
        if (_disposed)
        {
            return;
        }
 
        _disposed = true;
 
        if (_handle != IntPtr.Zero)
        {
            CloseHandle(_handle);
            _handle = IntPtr.Zero;
        }
    }

다음을 참조함 : _disposed, _handle, CloseHandle().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

SetInformationJobObject()

bool DreamineVMS.Services.Streaming.ChildProcessJob.SetInformationJobObject ( IntPtr hJob, JobObjectInfoType infoType, IntPtr lpJobObjectInfo, uint cbJobObjectInfoLength )

private

Information Job Object 값을 설정합니다.

매개변수

hJob	h Job에 사용할 IntPtr 값입니다.
infoType	info Type에 사용할 JobObjectInfoType 값입니다.
lpJobObjectInfo	lp Job Object Info에 사용할 IntPtr 값입니다.
cbJobObjectInfoLength	cb Job Object Info Length에 사용할 uint 값입니다.

반환값

Set Information Job Object 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

다음에 의해서 참조됨 : ChildProcessJob().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

_disposed

bool DreamineVMS.Services.Streaming.ChildProcessJob._disposed

private

disposed 값을 보관합니다.

ChildProcessJob.cs 파일의 44 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : AddProcess(), Dispose().

_handle

IntPtr DreamineVMS.Services.Streaming.ChildProcessJob._handle

private

handle 값을 보관합니다.

ChildProcessJob.cs 파일의 35 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : AddProcess(), ChildProcessJob(), Dispose().

JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE

const uint DreamineVMS.Services.Streaming.ChildProcessJob.JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE = 0x00002000

staticprivate

JOB OBJECT LIMIT KILL ON JOB CLOSE 값을 보관합니다.

ChildProcessJob.cs 파일의 172 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ChildProcessJob().

---

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

• ChildProcessJob.cs