Site Tools


documentation:development:opera:pf25:ppgfldr:mgsfldr:mprfldr:02mpr079

spIsSoundInUse

Determines if SPPlayer is currently reading from a particular SPSound.

Synopsis

bool spIsSoundInUse (const SPSound *sound)

Description

Determines if SPPlayer is currently reading from a particular SPSound. An SPSound cannot be removed from its owning SPPlayer while it is being read from while the player is running. This function is necessary for a client to know when it is safe to remove an SPSound.

Arguments

  • sound Pointer to SPSound to test.

Return Value

TRUE if sound is currently being read by player; FALSE otherwise.

Caveats

Returns FALSE too early for Sample Item class SPSounds. Since the spooler is given a pointer to the Sample Item's memory directly, rather than copying it into the spooler buffers, it must not return FALSE until a Sample Item SPSound has actually finished playing, not finished being read.

Implementation

Library call implemented in music.lib V24.

Associated Files

soundplayer.h, music.lib

See Also

spRemoveSound(), spStop()

documentation/development/opera/pf25/ppgfldr/mgsfldr/mprfldr/02mpr079.txt · Last modified: 2022/10/10 16:53 by 127.0.0.1