CAMMsgEvent::WaitMsg (Compact 2013)

  • Article

3/26/2014

Enables sent messages to be processed while waiting for an event to be signaled or for the indicated time-out to occur.

Syntax

BOOL WaitMsg(
  DWORD dwTimeOut
);

Parameters

  • dwTimeOut
    Optional time-out value, represented in milliseconds. The default is INFINITE.

Return Value

Returns TRUE if the event is signaled, or FALSE if the time-out occurred.

Remarks

Call CAMMsgEvent::WaitMsg rather than CAMEvent::Wait if you want to block on a time-out or a signaled event and continue to process sent messages.

If you do not process messages and another thread sends you a message, deadlock could occur.

For example, if you create a thread using the Win32 CreateThread function and block until the thread can initialize, deadlock occurs if the thread sends a message to your window using the Win32 SendMessage function. This is because SendMessage does not return until the message is processed.

CAMMsgEvent::WaitMsg allows SendMessage to return to the caller by using a Win32 PeekMessage loop to do message processing.

Requirements

Header

dshow.h,
Streams.h

Library

ole32.lib,
Ole32auth.lib,
Strmbase.lib,
Strmiids.lib,
uuid.lib

See Also

Reference

CAMMsgEvent Class