PtAppPulseTrigger()

Deliver a pulse to yourself

Synopsis:

int PtAppPulseTrigger( PtAppContext_t app, 
                       pid_t pulse );

Description:

This function allows an application to deliver a pulse to itself:

In Neutrino, this function uses (pulse | _NOTIFY_COND_MASK) to identify the pulse (and its handler), but the value of the pulse argument is delivered.
In QNX 4, the value of pulse must match the pulse PID exactly.

The app argument is the address of the application context, a structure that manages all the data associated with this application. For Photon 1.1x, this must be specified as NULL, so that the default context is used. The pulse argument is a pulse ID returned by PtAppCreatePulse().

Returns:

0: Success.
-1: An error occurred.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PtAppCreatePulse(), PtAppDeletePulse(), PtChannelCreate(), PtPulseArmFd(), PtPulseArmPid(), PtPulseDeliver(), PtPulseDisarm()

Interprocess Communication and Lengthy Operations in the Photon Programmer's Guide