PtAppPulseTrigger()

Deliver a Photon pulse to yourself

Synopsis:

int PtAppPulseTrigger( PtAppContext_t app, 
                       pid_t pulse );

Library:

ph

Description:

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

In QNX 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. 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(), PtPulseArm()

MsgDeliverEvent() in the QNX Neutrino Library Reference

Interprocess Communication in the Photon Programmer's Guide