PtResizeEventMsg()

Resize the event buffer

Synopsis:

int PtResizeEventMsg( PtAppContext_t app, 
                      int msg_size );

Description:

This function resizes 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 Readmsgmx() (see the C 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.

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.

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 and Lengthy Procedures chapter of the Photon Programmer's Guide