This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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

See also:

PtAppCreatePulse(), PtAppDeletePulse(), PtChannelCreate(), PtPulseArm()

MsgDeliverEvent() in the QNX Neutrino Library Reference

Interprocess Communication in the Photon Programmer's Guide