Remarks
Retrieves a specific WMA Standard profile.
The number of available WMA profiles can be obtained using the EncodeFormats.WMA.GetEncodingProfileCount method.
For further details about encoding in WMA format refer to the EncodeWMA class section.
For further information about available encoding formats see the EncodeFormatsMan class.
Syntax
[Visual Basic]
Public Function GetEncodingProfileInfo (
nIndexProfile as Int16,
ByRef nFrequency as Int32,
ByRef nChannels as Int16,
ByRef nInfo as Int32,
ByRef nEncodeMode as enumWmaEncodeModes
) as string
|
|
[C#]
public string GetEncodingProfileInfo (
Int16 nIndexProfile,
ref Int32 nFrequency,
ref Int16 nChannels,
ref Int32 nInfo,
ref enumWmaEncodeModes nEncodeMode
);
|
|
[C++]
public: string GetEncodingProfileInfo (
Int16 nIndexProfile,
Int32 __gc *nFrequency,
Int16 __gc *nChannels,
Int32 __gc *nInfo,
enumWmaEncodeModes __gc *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.
|
|