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

PfAllocDetailsCx()

Retrieve render buffer details

Synopsis:

#include <font_api.h>

int PfAllocDetailsCx( struct _Pf_ctrl * context,
                      char const ** name,
                      long * size );

Arguments:

context: A pointer to the font context to use, returned by PfAttachCx() or PfAttachDllCx().
name: A pointer to a location where the function stores the path and name of the shared memory, if context is not NULL.
size: A pointer to a long where the function stores the size, in bytes, of the render buffer.

Library:

font

Description:

This function retrieves the shared memory path and size of the render buffer associated with a font context. If the render buffer was allocated from the heap, the function sets name to NULL.

Returns:

0: Success
-1: An error occurred (errno is set).

Errors:

EFAULT: Font context is NULL.

Examples:

See the example for PfAttachDllCx().

Classification:

Photon

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	No
Thread	Yes