_pulse
QNX SDP8.0C Library ReferenceAPIDeveloper
Structure that describes a pulse
Synopsis:
#include <sys/neutrino.h>
struct _pulse {
uint16_t type;
uint16_t subtype;
int8_t code;
uint8_t zero[3];
union sigval value;
int32_t scoid;
};
Description:
The _pulse structure describes a pulse, a fixed-size, nonblocking message that carries a small payload (four bytes of data plus a single byte code). The members include:
- type
- _PULSE_TYPE (0)
- subtype
- _PULSE_SUBTYPE (0)
- code
- A code that identifies the type of pulse. QNX OS reserves the negative codes (see below). You can define your own pulses, with a code in the range from _PULSE_CODE_MINAVAIL through _PULSE_CODE_MAXAVAIL.
- value
- Information that's relevant to the code. If you define your own pulses, you can decide what information you want to store in this field.
- scoid
- Server connection ID.
The codes that the OS reserves, and the values sent with the pulse, include the following:
code | value |
---|---|
_PULSE_CODE_COIDDEATH | The connection ID of a connection that was attached to a destroyed channel |
_PULSE_CODE_DISCONNECT | No value defined |
_PULSE_CODE_RESTART | The cookie passed to MsgPause() that identifies the message that was paused |
_PULSE_CODE_THREADDEATH | The thread ID of the thread that died |
_PULSE_CODE_UNBLOCK | The receive ID (rcvid) associated with the blocking message |
For more details, see ChannelCreate().
Classification:
Page updated: