CMsgThread 클래스

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

클래스는 CMsgThread 비동기적으로 완료를 위해 큐 스레드에 요청을 큐에 대기하는 작업자 스레드 클래스입니다. 이 클래스를 사용하려면 클래스를 파생시키고 CMsgThread::ThreadMessageProc 멤버 함수를 재정의합니다. ThreadMessageProc 멤버 함수는 각 요청을 수행합니다. 클라이언트 함수와 ThreadMessageProc 멤버 함수는 CMsg 개체의 매개 변수에 대한 일반적인 정의를 공유해야 합니다.

협상된 메커니즘은 작업자 스레드에 종료를 지시합니다. 일반적으로 CMsg 클래스의 uMsg 메시지 코드 값 중 하나입니다.

파생 클래스의 소멸자에서 이 메시지를 보내고 파생 클래스의 소멸을 완료하기 전에 CMsgThread::WaitForThreadExit 멤버 함수를 호출하는 것이 좋습니다.

보호된 데이터 멤버	Description
m_hSem	신호에 사용되는 핸들을 나타냅니다.
m_Lock	목록에 대한 액세스를 보호합니다.
m_lWaiting	자유 스레드 대기 중임을 나타냅니다.
m_ThreadQueue	CMsgThread::GetThreadMsg 멤버 함수를 재정의하고 이 큐 이외의 항목을 차단합니다.
멤버 함수	Description
CMsgThread	CMsgThread 개체를 생성합니다.
CreateThread	스레드를 만듭니다.
GetThreadHandle	스레드 핸들을 검색합니다.
GetThreadID	스레드의 식별자를 검색합니다.
GetThreadPriority	현재 스레드 우선 순위를 검색합니다.
PutThreadMsg	작업자 스레드의 실행 요청을 큐에 대기합니다.
ResumeThread	작업자 스레드의 작업을 계속합니다.
SetThreadPriority	스레드의 우선 순위를 새 값으로 설정합니다.
SuspendThread	실행 중인 스레드의 작업을 일시 중단합니다.
WaitForThreadExit	CMsgThread::SuspendThread 멤버 함수를 호출한 후 스레드가 종료될 때까지 차단합니다.
재정의 가능한 멤버 함수	Description
GetThreadMsg	요청을 포함하는 큐에 대기 중인 CMsg 개체를 검색합니다.
OnThreadInit	스레드에서 초기화를 제공합니다.
ThreadMessageProc	요청을 처리합니다. 순수 가상 멤버 함수입니다.