Methods > Editors > LoadSoundEncrypted method

Remarks

Loads a song, previously encrypted through the CryptSound™ application or through the Audio Sound Recorder API for .NET component, from a given pathname for editing purposes.

You can manage how loaded sound will be added to the existing editing session through a previous call to the SetLoadingMode method.

You can limit the range of sound data that will be loaded from the given sound file with a previous call to the SetLoadingRange method.

Accepted stream formats are: MP1, MP2, MP3, MP4 (***), AIFF, AAC, M4A, AC3, FLAC, WavPack, ALAC, WAV, OGG Vorbis, OPUS, WMA (*), ASF (**), WMV (**), W64, AU, PAF, SVX, NIST, VOC, IRCAM, PVF, CAF, Speex, Musepack, Monkey's Audio (APE), MIDI.

Formats wrapped inside a RIFF container (for example GSM 6.10, ADPCM, CCITT, etc. ) are supported if the specific ACM (Audio Compression Manager) codec is installed inside the system.

Multi-channel WAV, AIFF, OGG Vorbis, OPUS and WMA formats are supported natively when the MultiChannelLoadingModeSet method has been invoked with the nMode parameter set to MULTICHAN_DOWNMIX_NONE while in other cases will be converted to stereo during the loading procedure.

During the execution of the loading session the CallbackPercentage delegate is invoked, with the nOperation parameter set to OPERATION_SOUND_LOADING, in order to notify about the percentage of advancement of the loading session.

For further details about callback delegates see the How to synchronize the container application with the API tutorial.

Syntax

[Visual Basic]

Public Function LoadSoundEncrypted (

strPathname as String,

strDecriptionKey as String

) as enumErrorCodes

[C#]

public enumErrorCodes LoadSoundEncrypted (

string strPathname,

string strDecriptionKey

);

[C++]

public: enumErrorCodes LoadSoundEncrypted (

string strPathname,

string strDecriptionKey

);

Parameter	Description

strPathname	String containing the absolute pathname of the encrypted song file to load.
strDecriptionKey	String containing the key used to originally encrypt the song: its length can be from a minimum of 16 characters to a maximum of 32 characters.

Return value

Value	Meaning

enumErrorCodes.ERR_NOERROR (0)	The song file has been loaded successfully.
Negative value	An error occurred: see the LastError property for further error details or for a list of the possible error values.

(*) Requires Microsoft Windows Media Format modules already installed on the target PC: you can verify the presence of these modules through a call to the IsWmaAvailable method.

(**) Only sound stream supported (no video): requires Microsoft Windows Media Format modules already installed on the target PC

(***) Only sound stream supported (no video)

The Windows Media Format modules can be installed using the redistribution setup package (wmfdist.exe) provided by Microsoft. Details about the integration of these modules inside your own setup package can be found on the following link of the official Microsoft web site (note that in the future this link could change due to the Microsoft site maintenance).