nn::snd::CTR::Voice::AppendWaveBuffer Member Function

void AppendWaveBuffer(
     WaveBuffer * buffer
);

	Name	Description
in	buffer	Pointer to a buffer information structure.

None.

Appends sample data information corresponding to a voice.

There is no upper limit to the number of sets of buffer information that this function can append. Even if a voice is in the playback state, it does not produce audio output if it has no registered sound source data. Likewise, even if sound source data has been registered in a voice, the voice does not produce audio output in the stopped state.

All of the following conditions must be met by the buffer memory region.

• The region has been obtained by the nn::os::GetDeviceMemoryAddress function.
• The region is contiguous (specify nn::os::ALLOCATE_OPTION_LINEAR as an allocator option).
• The starting address is 32-byte aligned.
• The buffer size is a multiple of 32 bytes.

However, there are no restrictions on sample length. For instance, when adding a sample from a PCM8 monaural sound source, the data is 1 byte, but due to the 32-byte multiple restriction, the buffer must be allocated as 32 bytes.

The buffer region must always be written back from the cache to memory using the nn::snd::CTR::FlushDataCache function. To reduce the processing load, call nn::snd::CTR::FlushDataCache only when necessary.

2010/07/22

Added a description of buffer memory region requirements.

2010/01/29

Initial version.