COM Objects > Waveform object > Methods > Waveform.PeaksLoadFromMemory method

Remarks

Loads the analyzed sound's peaks from a file of type PKW generated by a previous call to the Waveform.PeaksSave method and stored into a memory buffer: this avoids the need to perform a new time consuming full analysis of the sound's waveform for a sound file whose contents have not been changed.

This method will generate the same WaveAnalysisStart and WaveAnalysisDone events as seen when calling the Waveform.AnalyzeFullSound method.

For further details about using the embedded Waveform refer to the Waveform object section.

For further details about generating a waveform bitmap of the loaded sound, before starting its playback, refer to the How to obtain the sound's waveform tutorial.

Syntax

[Visual Basic]

control.Waveform.PeaksLoadFromMemory (

nPlayer as Integer,

pBuffer as Variant,

nBufferLen as Long

) as enumErrorCodes

[C++]

short control.Waveform.PeaksLoadFromMemory (

short nPlayer,

const VARIANT FAR& pBuffer,

long nBufferLen

);

Parameter	Description

nPlayer	Number representing the zero-based index of the player that will use the waveform
pBuffer	Variant parameter containing the pointer to waveform peaks previously loaded in memory.
nBufferLen	Length in bytes of the given buffer

Return value

Value	Meaning

Negative value	An error occurred, check the LastError property value in order to get the error code
enumErrorCodes.ERR_NOERROR (0)	The method call was successful