ATMI C Function Reference
|
 |
 |
|
 |
 |
AEPisblocked(3c)
Name
AEPisblocked()—Determines 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
If there is an outstanding blocking function awaiting completion, AEPisblocked() returns 1. Otherwise, it returns 0.
Errors
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 reentered, depending on the message(s) it receives. In this instance, the AEPisblocked() function can be used to ascertain whether the task has been reentered while waiting for an outstanding blocking call to complete. Note that ATMI prohibits more than one outstanding call per thread.
