Copyright © 2006-2018 MultiMedia Soft

EncodeFormats.WMA.GetEncodingProfileInfo method

Previous pageReturn to chapter overviewNext page

Remarks

 

Retrieves a specific WMA Standard profile.

The number of available WMA Standard profiles can be obtained using the EncodeFormats.WMA.GetEncodingProfileCount method.

 

For further details about encoding in WMA format refer to the WMA object section.

For further information about available encoding formats see the EncodeFormats object.

 

 

Syntax

 

[Visual Basic]

control.EncodeFormats.WMA.GetEncodingProfileInfo (

nIndexProfile as Integer,

nFrequency as Long,

nChannels as Integer,

nInfo as Long,

nEncodeMode as enumWmaEncodeModes

) as String


 

[C++]

LPCTSTR control.EncodeFormats.WMA.GetEncodingProfileInfo (

short nIndexProfile,

long *nFrequency,

short *nChannels,

long *nInfo,

short *nEncodeMode

);


 

 

 

Parameter

Description

 

 

nIndexProfile

Zero-based index of the WMA profile

nFrequency

Reference that, after returning from the method call, will contain the frequency, expressed in Hertz, of the WMA profile

nChannels

Reference that, after returning from the method call, will contain the number of channels of the WMA profile

nInfo

Reference that, after returning from the method call, will contain the value of the profile which, depending upon the value returned into the nEncodeMode parameter, may be a bitrate for CBR profiles or a quality for VBR profiles

nEncodeMode

Reference that, after returning from the method call, will contain the WMA encode mode which indicates if the WMA profile is based upon CBR or VBR.

Supported values are the following:

Mnemonic Value

Value

Meaning

WMA_ENCODE_VBR_QUALITY

0

The nInfo parameter contains a Variable Bitrate (VBR) quality value.

WMA_ENCODE_CBR_STD_16

1

The nInfo parameter contains a Constant Bitrate (CBR) value.

 

 

Return value

 

Value

Meaning

 

 

Empty string

An error occurred. Check the LastError property value in order to see the last error.

Valid string

The string containing the friendly description of the requested WMA profile like in the examples below:

 

8,000 Hz; Stereo; CBR 12 kbps

44,100 Hz; Mono; CBR 20 kbps

48,000 Hz; Stereo; VBR Quality 90

etc.

 

The thousands separator used for the frequency value may vary depending upon the locale of the PC running the component.