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

PtAppDeletePulse()

Delete a Photon pulse

Synopsis:

int PtAppDeletePulse( PtAppContext_t app,
                      pid_t pulse_pid );

Library:

ph

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. This must be specified as NULL, so that the default context is used.

---

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

See also:

PtAppCreatePulse(), PtAppPulseTrigger(), PtChannelCreate(), PtPulseArm()

MsgDeliverEvent() in the QNX Neutrino Library Reference

Interprocess Communication in the Photon Programmer's Guide