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

PhGetMsgSize()

Get message size

Synopsis:

unsigned PhGetMsgSize( PhEvent_t const *event_buf );

Library:

ph

Description:

This function returns the size of buffer necessary to contain the event that couldn't fit into the current buffer. You typically use this function after PhEventRead(), PhEventPeek(), or PhEventNext() has returned a value of Ph_RESIZE_MSG.

These functions can return Ph_RESIZE_MSG only if the application set the Ph_DYNAMIC_BUFFER flag when it attached the Photon channels; see PhAttach().

Returns:

The size of the buffer required to accommodate the entire event.

Examples:

See PhEventRead().

Classification:

Photon

See also:

PhAttach(), PhEvent_t, PhEventNext(), PhEventPeek(), PhEventRead()