Classe CMsgThread

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A CMsgThread classe é uma classe de thread de trabalho que enfileira solicitações para o thread de enfileiramento para conclusão de forma assíncrona. Para usar essa classe, derive sua classe dela e substitua a função membro CMsgThread::ThreadMessageProc . A função membro ThreadMessageProc executa cada solicitação. Suas funções de cliente e a função membro ThreadMessageProc devem compartilhar uma definição comum dos parâmetros no objeto CMsg .

Um mecanismo negociado informa ao thread de trabalho para sair. Normalmente, esse será um valor do código de mensagem uMsg da classe CMsg .

É uma boa ideia enviar essa mensagem do destruidor da classe derivada e chamar a função membro CMsgThread::WaitForThreadExit antes de concluir a destruição da classe derivada.

Membros de Dados Protegidos	Descrição
m_hSem	Indica um identificador usado para sinalização.
m_Lock	Protege o acesso a listas.
m_lWaiting	Indica a espera de um thread gratuito.
m_ThreadQueue	Substitui a função membro CMsgThread::GetThreadMsg e bloqueia itens diferentes dessa fila.
Funções de membro	Descrição
Cmsgthread	Constrói um objeto CMsgThread .
CreateThread	Cria um thread.
GetThreadHandle	Recupera o identificador de thread.
GetThreadID	Recupera o identificador do thread.
Getthreadpriority	Recupera a prioridade atual do thread.
PutThreadMsg	Enfileira uma solicitação de execução pelo thread de trabalho.
ResumeThread	Continua a operação do thread de trabalho.
SetThreadPriority	Define a prioridade do thread como um novo valor.
SuspendThread	Suspende a operação de um thread em execução.
WaitForThreadExit	Bloqueia até que o thread seja encerrado após uma chamada para a função membro CMsgThread::SuspendThread .
Funções de membro substituíveis	Descrição
GetThreadMsg	Recupera um objeto CMsg na fila que contém uma solicitação.
OnThreadInit	Fornece inicialização em um thread.
ThreadMessageProc	Processa solicitações. Essa é uma função membro virtual pura.