Notify another thread.

An application can use an notify object to trigger execution of other threads. This is useful if, for example, one thread provides data to many other threads. Using an notify object frees the other threads from the trouble of polling to determine when new data is available.

None of the functions in this class throws exceptions because an exception probably has been thrown already or is about to be thrown.

You can construct and destruct objects of this class.

Source:

pm_notify.h:33

Author:

Dmitry A.Steklenev

Version:

$Revision: 1.2 $

Entity	Inherited From	Type	Scope	Short Description
PMNotify		constructor	public	Constructs the notify object.
~PMNotify		destructor	public	Destructs the notify object.
post		method	public	Posts the notify.
wait		method	public	Waits the notify.
wait		method	public	Waits the notify with timeout.
reset		method	public	Resets the notify.

Constructs the notify object.

Source:

pm_notify.h:36

Code:

public PMNotify (

)

Destructs the notify object.

Source:

pm_notify.h:38

Code:

public ~ PMNotify ( )

Posts the notify.

Causing all of the threads that were blocked on wait requests for that object to execute.

Source:

pm_notify.h:49

Returns:

TRUE, if notify posted.

Code:

public BOOL post (

)

Waits the notify.

Enables a thread to wait for an notify to be posted.

Source:

pm_notify.h:59

Returns:

TRUE, if notify received.

Code:

public BOOL wait (

) const

Waits the notify with timeout.

Enables a thread to wait for an notify to be posted.

Source:

pm_notify.h:71

Param:

mseq	This is the maximum amount of time the user wants to allow the thread to be blocked.

Returns:

TRUE, if notify received.

Code:

public BOOL wait (

unsigned long msec ) const

Resets the notify.

Resets an object, causing all threads that subsequently call wait to be blocked.

Source:

pm_notify.h:82

Returns:

TRUE, if resets succesfull.

Code:

public BOOL reset (

)