Método CMsgThread.ThreadMessageProc

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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.]

Processa solicitações. Essa é uma função membro virtual pura.

Sintaxe

virtual LRESULT ThreadMessageProc(
   UINT     uMsg,
   DWORD    dwFlags,
   LPVOID   lpParam,
   CAMEvent *pEvent
);

Parâmetros

uMsg

Código da solicitação.

dwFlags

Parâmetro de sinalizador opcional a ser solicitado.

lpParam

Ponteiro opcional para dados extras ou um bloco de dados de retorno.

pEvent

Ponteiro opcional para um objeto de evento.

Retornar valor

Qualquer retorno diferente de zero faz com que o thread seja encerrado. Retorna zero, a menos que uma solicitação de saída tenha sido processada recentemente.

Comentários

Essa função virtual pura deve ser substituída em sua classe derivada. Ele será chamado uma vez para cada solicitação enfileirada por uma chamada para a função membro CMsgThread::P utThreadMsg .

A função membro define os quatro parâmetros. Normalmente, use o parâmetro uMsg para indicar a solicitação e os outros três parâmetros serão parâmetros adicionais opcionais. O aplicativo de chamada pode fornecer um ponteiro para um objeto CAMEvent no parâmetro pEvent se o aplicativo exigir. Você deve definir esse evento depois de processar o evento usando uma expressão como:

pEvent->SetEvent

Um código de solicitação deve ser reservado para instruir o thread de trabalho a sair. Ao receber essa solicitação, retorne 1 dessa função membro. Retorne 0 se você não quiser que o thread de trabalho seja encerrado.

Requisitos

Requisito Valor
parâmetro
Msgthrd.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CMsgThread