Appendix > APPENDIX B - Guidelines for DirectShow configuration through K-Lite

Remarks

Obtains information about the loaded sound and about embedded Tags. When a sound is loaded, in order to speed up its availability for playback, the only immediately available information is its duration: further information can be retrieved at a later time calling this method.

Syntax

[Visual Basic]

Public ReadSoundInfo2 (

nPlayerIndex as Int16,

byref info as SoundInfo2

) as Int16

[C#]

public Int16 ReadSoundInfo2 (

Int16 nPlayerIndex,

ref SoundInfo2 info

);

[C++]

public: Int16 ReadSoundInfo2 (

Int16 nPlayerIndex,

SoundInfo2 __gc* __gc* info

);

Parameter	Description

nPlayerIndex	Number representing the zero-based index of the involved player
info	Reference to a SoundInfo2 class instance that will contain information about the loaded song

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.NOERROR (0)	The method call was successful.

Sample

Below you can find some sample that demonstrates how to get information about a loaded song.

Visual Basic.NET

' load a song inside player 0

AudioDjStudio1.LoadSound(0, "c:\mysong.mp3")

' instantiate a SoundInfo2 object and fill it with song information

Dim info As New AudioDjStudio.SoundInfo2

AudioDjStudio1.ReadSoundInfo2(0, info)

Visual C#.NET

// load a song inside player 0

audioDjStudio1.LoadSound (0, "c:\\mysong.mp3");

// instantiate a SoundInfo2 object and fill it with song information

AudioDjStudio.SoundInfo2 info = new AudioDjStudio.SoundInfo2 ();

audioDjStudio1.ReadSoundInfo2 (0, ref info);

Visual C++.NET

// load a song inside player 0

audioDjStudio1->LoadSound (0, "c:\\mysong.mp3");

// instantiate a SoundInfo2 object and fill it with song information

AudioDjStudio::SoundInfo2 *info = new AudioDjStudio::SoundInfo2 ();

audioDjStudio1->ReadSoundInfo2 (0, &info);