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

See also:

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

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