7.Function specification-2

7.2 Stream Group

one View table

Title function specification

Function Opening a stream group

Function name STM_OpenGrp

No 2.1

Format

StmGrpHn STM_OpenGrp(void)

input

none

output

none

function value

NULL for stream group handle error

function

Open a stream group.

one View table

Title function specification

Function Closing a stream group

Function name STM_CloseGrp

No 2.2

Format

void STM_CloseGrp(StmGrpHn grp)

input

grp: stream group handle

output

none

function value

none

function

Close the stream group.

remarks

All streams belonging to the stream group will be closed.

one View table

Title function specification

Function Get the number of streams

Function name STM_GetStmNum

No 2.3

Format

Sint32 STM_GetStmNum(StmGrpHn grp)

input

grp: stream group handle

output

none

function value

Number of streams belonging to the stream group.

function

Gets the number of streams belonging to the specified stream group.

one View table

Title function specification

Function Get stream handle

Function name STM_GetStmHndl

No 2.4

Format

StmHn STM_GetStmHndl(StmGrpHn grp, Sint32 nstm)

input

grp	:stream group handle
nstm	: Playback order number (0 ≦ nstm＜ STM_GetStmNum)

output

none

function value

Stream handle for the specified playback order number.
NULL if there is no corresponding stream.

function

Gets the handle of the stream belonging to the specified stream group.

remarks

If the following four streams belong to the same stream group, the playback order numbers will be in the order of streams A, B, C, and D.

one View table

Title function specification

Function Registering buffer size monitoring function

Function name STM_SetCdbufFunc

No 2.5

Format

void STM_SetCdbufFunc(StmGrpHn grp, StmHn stm, Sint32 nsct,StmCdbufFunc func, void *obj)

input

grp	:stream group handle
stm	:Stream handle (STM_CDBUF_REST when checking free sectors)
nsct	: Number of sectors
func	: Buffer size monitoring function (STM_CDBUF_NULLFUNC when canceling)
obj	:Registered object

output

none

function value

none

function

Registers a buffer size monitoring function for the specified stream group. The registration function is called under the following conditions:

stm value	Conditions for calling the monitoring function func
normal stream handle	Stream data in CD buffer＞ nsct
STM_CDBUF_REST	CD buffer free space ≦ nsct

remarks

1. The registration function has the following format:
   void (*StmCdbufFunc)(void *obj)

2. The registration object is passed to the first argument of the registration function.