#include <cafe.h> #include <cafe/ax.h> s32 AXVoiceBegin(AXVPB *p);
|p||Pointer to the AX Voice management structure to be protected.|
||Voice is protected by another thread. Try again later.|
||Attempted to call
||Protection state for this voice has been asserted.|
Asserts a protection state for the specified voice.
During a protection state any changes to the parameters of the specified voice,
made via the
AXSetVoice... functions, will be buffered until the
protection state is terminated (
After the protection state is terminated, the buffered parameters can be committed to the renderer at the next audio frame.
It is possible to nest BEGIN/END clauses. Note that the nesting limit is equal to
Making this call from a callback handler will return
AXSYNC_ERROR_IN_CALLBACK but have no other effect.
Nor will its matching
AXVoiceEnd call have any effect.
It is possible to get a return value of
AXSYNC_ERROR_IN_CALLBACK from calls not made during
the callback handler. This is an indication of a programming error elsewhere in the application,
OSLockMutex) from any callback handler, Audio or other.
2013/05/08 Automated cleanup pass.
2011/03/02 Initial version.