Caution: 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

See also:

PfAttachCx(), PfAttachDllCx()

Fonts chapter of the Photon Programmer's Guide