Format Sint32 BPL_SetBranchInfo (Sint32 batmid, Sint32 nbranch, Sint32 * brtbl)
Input bstmid: Branch stream identifier
Nbranch: Number of branch destinations
Brbrt: Branch table
No output
Function value Error code
Function Sets branch destination information (branch destination candidates) for a branch stream.
Remarks (a) The branch stream identifier of the branch candidate is set in the branch table.
To set without branch destination, specify BPL_BR_NONE for the branch table element.
That thing.
: Brtbl [0] = BSTMID_A;
: Brtbl [1] = BPL_BR_NONE; / * No branch destination (end of branch playback) * /
Brtbl [2] = BSTMID_B;
Nbranch = 3;
Branch destination is specified by the BPL_SelectBranch function and the branch number (position in the branch table).
Stipulated.
In this example, branch processing is as follows depending on the selected branch destination.
Selected branch destination | Branch processing (when the server function branch execution switch is ON) |
branch number 0 | Branch to branch stream identifier BSTMID_A. |
Branch number 1 | Branch playback ends. (Immediately after selection, there is no branch destination.) |
branch number 2 | Branch to branch stream identifier BSTMID_B. |
Other | (BPL_SelectBranch returns BPL_ERR_BRNO error and selection disabled) |
(b) The number of streams must satisfy the following conditions.
X + Y ≦ Z
X: Number of stream keys set in X: bstmid
, Y: Total number of branch stream keys
Z: Maximum number of streams that can be opened simultaneously (specified by the STM_Init function)