nn::snd::CTR::Voice::UpdateWaveBuffer Member Function

void UpdateWaveBuffer(
     WaveBuffer * pBuffer
);

	Name	Description
in	pBuffer	Pointer to a buffer information structure.

None.

This updates buffer information appended to a voice.

You must call this function immediately after updating the specified WaveBuffer information (Note: The parameters may be updated even if this function is not called). The only variables that can be modified are sampleLength and loopFlag. Behavior is not guaranteed if any other parameters are modified.

This function will have no effect if a pointer to a WaveBuffer that has not been appended is specified in the parameter. The actual update takes place when nn::snd::CTR::SendParameterToDsp is called. For this reason, the WaveBuffer pointer specified in the parameter still may not be updated even if it has been appended (e.g., if the state of the WaveBuffer before the update is nn::snd::CTR::WaveBuffer::STATUS_DONE).

Note the following when modifying sampleLength.

• As described above, the update takes place when nn::snd::CTR::SendParameterToDsp is called. Thus, even if sampleLength is smaller than the current value, it is possible that the latter portion of the buffer (the region after the new value) will be referenced immediately after this function is called.
• If the newly specified sampleLength value is smaller than the current playback position, playback will stop immediately, or a buffer jump will be performed.

2010/06/06

Initial version.