EncodeFormats.WMA.GetEncodingProfileInfo method |
|
Remarks
Retrieves a specific profile for the WMA Professional format.
The number of available WMA profiles can be obtained using the EncodeFormats.WMA.GetEncodingProfileProCount 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, nBitsPerSample as Int16, nInfo as Long, nEncodeMode as enumWmaEncodeModes ) as String |
[C++] LPCTSTR control.EncodeFormats.WMA.GetEncodingProfileInfo ( short nIndexProfile, long *nFrequency, short *nChannels, short *nBitsPerSample, 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 |
|||||||||
nBitsPerSample |
Reference that, after returning from the method call, will contain the number of bits per sample used for encoding. WMA Professional supports both 16 and 24 bits per sample. |
|||||||||
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 the WMA Professional encode mode. Supported values are the following:
|
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:
32,000 Hz; Stereo; 16 bits; CBR 32 kbps 44,100 Hz; Stereo; 24 bits; CBR 440 kbps 44,100 Hz; Stereo; 24 bits; CBR 384 kbps etc.
The thousands separator used for the frequency value may vary depending upon the locale of the PC running the component. |