CAMMsgEvent::WaitMsg (Windows CE 5.0)
Enables sent messages to be processed while waiting for an event to be signaled or for the indicated time-out to occur.
BOOL WaitMsg(DWORDdwTimeOut);
Parameters
- dwTimeOut
Optional time-out value, represented in milliseconds. The default is INFINITE.
Return Values
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
DirectShow applications and DirectShow filters have different include file and link library requirements.
For more information, see Setting Up the Build Environment.
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:
Send Feedback on this topic to the authors