PtAppCreatePulse()

Create a Photon pulse

Synopsis:

pid_t PtAppCreatePulse( PtAppContext_t app, 
                        int priority );

Library:

ph

Description:

This function creates a Photon pulse. Under version 4 of the QNX OS, PtAppCreatePulse() creates a proxy; under version 6, it creates a Neutrino pulse.

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 priority parameter specifies the priority of the pulse. If priority is -1, the pulse's priority is the same as that of the calling process.

Returns:

A pulse PID (a negative value that's guaranteed never to be -1), or 0 if an error occurred.

Classification:

Photon

See also:

PtAppDeletePulse(), PtAppPulseTrigger(), PtChannelCreate(), PtPulseArm()

MsgDeliverEvent() in the QNX 6 Library Reference

Interprocess Communication in the Photon Programmer's Guide