PtAppCreatePulse()

Create a Photon pulse

Synopsis:

pid_t PtAppCreatePulse( PtAppContext_t app, 
                        int priority );

Description:

This function creates a Photon pulse. Under QNX 4, a proxy is created. Under Neutrino, a pulse or realtime signal will be used.

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 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(), PtPulseArmFd(), PtPulseArmPid(), PtPulseDeliver(), PtPulseDisarm()

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