[Previous] [Contents] [Index] [Next]

PtAppDeletePulse()

Delete a Photon pulse

Synopsis:

int PtAppDeletePulse( PtAppContext_t app,
                      pid_t pulse_pid );

Description:

This function deletes the Photon pulse identified by pulse_pid (and the proxy in QNX 4). The pulse_pid identifies a pulse created by PtAppCreatePulse().

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.


Note: If the application creates and destroys pulses frequently, the pulse ID will be reused eventually. At least several hundred pulses can be safely created and destroyed before that happens. If a pulse ID is reused but notifications are still generated with the old pulse, they may or may not be delivered to the new pulse handler.

Returns:

0
Success.
-1
An error occurred.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

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

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


[Previous] [Contents] [Index] [Next]