HP SVA V2.1 Parallel Compositing Reference Guide

pcContextCreateMaster(3)
NAME
pcContextCreateMaster -- Creates a context as the master.
Synopsis
PCerr pcContextCreateMaster(
const PCint *properties,
PCstring *hosts,
PCstring thisHost,
PCcontext *ctx
);
Parameters
properties
An array of initial properties for the context. The array is a series of value pairs
as follows:
• The first element of the pair is the name of a property listed in Table 2-7 in
the Parallel Compositing Library Reference Guide. Terminate the array pairs
by using the constant PC_PROPERTY_END as the first element.
• The second element is the initial value of the property.
Only properties marked “Yes” in the Can Set On Context Create column of
Table 2-7 can be used in this array.
hosts An array describing the hosts of this context. The array has one element per
host. Each host is described using a string with the following format:
hostName:hostId
The end of the array is indicated by an array element with a NULL value.
thisHost The name of this host in the following format:
hostName:hostId
This host must be one of the hosts in the hosts parameter.
ctx A variable to hold the context that is created.
Returns
This function returns PC_NO_ERROR on successful completion.
Description
This function is used by the master host to create a context. The master’s name (thisHost) must
be one of the hosts listed in the hosts parameter. The properties parameter specifies the initial
properties of the context. Certain parameters can only be specified when the context is created.
These properties may only be specified using the properties parameter.
This function will not return until all hosts have created the context, or the Library encounters
an error creating a context. On a successful return, the ctx parameter is set to a PCcontext value
that can be used in other functions requiring a context.
47