[Top] [Prev] [Next] [Bottom]

AEPisblocked(3)

AEPisblocked(3)

Name

AEPisblocked-determine if a blocking call is in progress

Synopsis

#include <atmi.h>
int far pascal AEPisblocked(void)

Description

AEPisblocked() is an "ATMI Extension for OS/2 Presentation Manager" that allows a OS/2 PM task to determine if it is executing while waiting for a previous blocking call to complete.

Return Values

AEPisblocked() returns 1 if there is an outstanding blocking function awaiting completion. Otherwise, it returns 0.

Errors

No errors are returned.

Portability

This interface is supported only in OS/2 PM clients.

Comments

Although a blocking ATMI call appears to an application as though it "blocks," the OS/2 PM ATMI DLL has to relinquish the processor to allow other applications to run. This means that it is possible for the application which issued the blocking call to be re-entered, depending on the message(s) it receives. In this instance, the AEPisblocked() function can be used to ascertain whether the task has been re-entered while waiting for an outstanding blocking call to complete. Note that ATMI prohibits more than one outstanding call per thread.

See Also

AEPsetblockinghook()



[Top] [Prev] [Next] [Bottom]