Класс CMsgThread

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Класс CMsgThread — это класс рабочего потока, который асинхронно помещает в очередь запросы к потоку очередей для завершения. Чтобы использовать этот класс, наследуйте класс от него и переопределите функцию-член CMsgThread::ThreadMessageProc . Функция-член ThreadMessageProc выполняет каждый запрос. Клиентские функции и функция-член ThreadMessageProc должны совместно использовать общее определение параметров в объекте CMsg .

Согласованный механизм сообщает рабочему потоку о выходе. Как правило, это одно значение кода сообщения uMsg класса CMsg.

Рекомендуется отправить это сообщение из деструктора производного класса и вызвать функцию-член CMsgThread::WaitForThreadExit , прежде чем завершить уничтожение производного класса.

Защищенные члены данных	Описание
m_hSem	Указывает дескриптор, используемый для сигнализации.
m_Lock	Защищает доступ к спискам.
m_lWaiting	Указывает на ожидание свободного потока.
m_ThreadQueue	Переопределяет функцию-член CMsgThread::GetThreadMsg и блокирует объекты, отличные от этой очереди.
Функции элементов	Описание
CMsgThread	Создает объект CMsgThread .
CreateThread	Создает поток.
GetThreadHandle	Извлекает дескриптор потока.
GetThreadID	Извлекает идентификатор потока.
GetThreadPriority	Извлекает приоритет текущего потока.
PutThreadMsg	Помещает в очередь запрос на выполнение рабочим потоком.
ResumeThread	Продолжает работу рабочего потока.
SetThreadPriority	Задает приоритет потока в качестве нового значения.
SuspendThread	Приостанавливает работу выполняющегося потока.
WaitForThreadExit	Блокируется, пока поток не завершит работу после вызова функции-члена CMsgThread::SuspendThread .
Переопределимые функции-члены	Описание
GetThreadMsg	Извлекает объект CMsg в очереди, содержащий запрос.
OnThreadInit	Обеспечивает инициализацию в потоке.
ThreadMessageProc	Обрабатывает запросы. Это чистая виртуальная функция-член.