Copyright © 2008-2015 MultiMedia Soft

EncodeFormats.WMA.GetEncodingProfileProInfo method

Previous pageReturn to chapter overviewNext page

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 EncodeWMA class section.

For further information about available encoding formats see the EncodeFormatsMan class.

 

 

Syntax

 

[Visual Basic]

Public Function GetEncodingProfileProInfo (

nIndexProfile as Int16,

ByRef nFrequency as Int32,

ByRef nChannels as Int16,

ByRef nBitsPerSample as Int16,

ByRef nInfo as Int32,

ByRef nEncodeMode as enumWmaEncodeModes

) as string


 

[C#]

public string GetEncodingProfileProInfo (

Int16 nIndexProfile,

ref Int32 nFrequency,

ref Int16 nChannels,

ref Int16 nBitsPerSample,

ref Int32 nInfo,

ref enumWmaEncodeModes nEncodeMode

);


 

[C++]

public: string GetEncodingProfileProInfo (

Int16 nIndexProfile,

Int32 __gc *nFrequency,

Int16 __gc *nChannels,

Int16 __gc *nBitsPerSample,

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

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:

Mnemonic Value

Value

Meaning

WMA_ENCODE_CBR_PRO_16

3

WMA Professional format at 16 bits per sample.

WMA_ENCODE_CBR_PRO_24

4

WMA Professional format at 24 bits per sample.

 

 

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.