ILMAC3Encoder

This is the interface for the LEAD AC3 Encoder.

Data Types

LEncAC3_APILEVEL

Summary

Lists the valid values for the ApiLevel parameter that can be passed to the ResetToDefaultsEx method.

Syntax

typedef enum  
{ 
   LEncAC3_APILEVEL_1, 
} LEncAC3_APILEVEL;

Members

LEncAC3_APILEVEL_1

Use the defaults from the current version of the codec.

eAC3OutputChannels

Summary

Specifies the number of output channels.

Syntax

enum 
{ 
   LENCAC3_UNCHANGED = 0, 
   LENCAC3_FORCE_MONO = 1, 
   LENCAC3_FORCE_STEREO = 2, 
   LENCAC3_FORCE_6CHANNELS = 6 
} eAC3OutputChannels;

Members

LENCAC3_UNCHANGED

The number of output channels equals the number of input channels.

LENCAC3_FORCE_MONO

There is 1 output channel.

LENCAC3_FORCE_STEREO

There are 2 output channels.

LENCAC3_FORCE_6CHANNELS

There are 6 output channels.

Properties

Type	Name	Description
long	OutputBitrate	Sets the output bitrate of the compressed audio data. The bitrate is the average number of bits that one second of audio data will take up in the compressed bitstream. The bitrate represents the strength of compression. It also influences quality: the higher the bitrate, the higher the quality. The unit of measure for the bitrate is in kbps. To calculate the number of bytes per second of audio data, divide the bitrate value by eight. The following bitrate values are valid: 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 384, 448, 512, 576, 640.
eAC3OutputChannels	OutputChannelsFlag	An enumeration that specifies the number of output channels.
BOOL	SimulateSurround	Enables or disables surround sound simulation. The following values are possible:
		• TRUE - Enables surround sound simulation.
		• FALSE - Disables surround sound simulation. This property is used only if the LENCAC3_FORCE_6CHANNELS eAC3OutputChannels value is selected.
long	OutputSampleRate	The output sample rate, in samples per second (Hz).The following values are possible: 32000, 44100, 48000.

Methods

HRESULT ResetToDefaultsEx(LEncAC3_APILEVEL ApiLevel);

Description

Resets the filter to default values.

Parameters

ApiLevel

Specifies which defaults should be used by the filter. Current applications should set ApiLevel to LEncAC3_APILEVEL_1 = 0.

Comments

The filter might change in the future and have different properties or default behavior. Calling this method ensures future versions of the filter will behave the same way as when the application was developed.

It is best to call ResetToDefaultsEx(LEncAC3_APILEVEL_1) before you start setting properties and start calling other methods for this interface.