#include <nitro/snd.h>
BOOL SND_GetNextInstData( const SNDBankData* bank, SNDInstData* inst, SNDInstPos* pos );
bank |
This is the bank data pointer. |
inst |
This is the pointer to the structure that stores the obtained instrument data. |
pos |
This is the instrument data positional information. |
Returns TRUE if the instrument data is successfully obtained. Returns FALSE if the next instrument data does not exist.
Gets the instrument data in the bank data in order.
If the instrument data is successfully obtained, the SNDInstData
format instrument data is written to the memory region designated with inst
. Furthermore, pos
, which indicates the instrument data positional information, is updated so that it indicates the position of the next instrument data.
When first calling this function, the instrument data positional information obtained with the SND_GetFirstInstDataPos
function must be passed to pos
.
SNDInstPos pos = SND_GetFirstInstDataPos( bank ); SNDInstData inst; while( SND_GetNextInstData( bank, &inst, &pos ) ) { // Process to perform for the instrument }
SNDInstData
, SND_GetFirstInstDataPos
01/20/2005 Initial version