PMOPENCONTEXT(3)

PM Programmer's Manual

PMOPENCONTEXT(3)

NAME

pmOpenContext - open a pmContext object

SYNOPSIS

int pmOpenContext(pmDevice *pmd, int ctx_num, pmContext **pmcp);

ARGUMENTS

pmDevice *	pmd	IN	pmDevice object
int	ctx_num	IN	Context number
pmContext **	pmcp	OUT	pmContext object

IMPLEMENTATION LEVEL

BASE

DESCRIPTION

pmOpenContext() opens a pmContext object specfied by ctx_num from a pmDevice pmd.

NOTES

The initial state of the new context is:

• No channel is bounded.
• Sending is enabled.
• No nodes are associated.
• No member context is added (for composite context).

INTERNAL

The new context must be initialized using the INIT_CONTEXT macro.

RETURN VALUES

PM_SUCCESS	Success
EINVAL	ctx_num is out of range
EBUSY	Context is already opened
ENOMEM	Not enough memory
EIO	Internal error

---