PtResizeEventMsg()

Resize the event buffer

Synopsis:

int PtResizeEventMsg( PtAppContext_t app, 
                      int msg_size );

Library:

ph

Description:

This function sets the size the Photon event buffer, which receives all events on behalf of a Photon application. Using this function to increase the acceptable message size allows larger non-Photon messages to be received by the Photon application without requiring MsgReadv() (see the QNX Neutrino Library Reference).


Note: PtResizeEventMsg() won't reduce the message buffer beyond a certain minimum size. This is so that the widget library will continue to function.

PtResizeEventMsg() doesn't actually reallocate any message buffers. It just sets the size to be used for them.


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.

Returns:

0
Successful completion.
-1
An error occurred.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

Receiving QNX messages in the Interprocess Communications chapter of the Photon Programmer's Guide