ScanSample

Loads a truncated sample file.

Synopsis

Item ScanSample( char *Name, int32 BufferSize )

Description

This function is similar to LoadSample(), but allocates only as much memory as specified by BufferSize. It then loads as much of the sample data as will fit. This is handy for loading the first part of a very large sound file that won't fit in memory.

Arguments

Name: Name of an AIFF or AIFC file.

BufferSize: Amount of memory to allocate (in bytes).

Return Value

The function returns a Sample Item number if successful or an error code ( a negative value) if an error occurs.

Caveats

Any loop points in an AIFF or AIFC file beyond the BufferSize cause this function to return an error.

Implementation

Folio call implemented in Audio folio V20.

Associated Files

audio.h