In This Topic ▼

ILMSsfWrtAudioStream Interface

Interface Properties:

Type	Name	Description
long	BitrateSupportedCount	(Read-only) Gets the current count of supported bitrates.
long	Bitrate	Gets or sets the desired bitrate for the audio stream. This value is in kilobits/second.
long	ChannelsSupportedCount	(Read-only) Gets the current count of audio channels supported.
long	Channels	Gets or sets the channels type (Stereo, 5.1, 7.1).
long	SampleRateSupportedCount	(Read-only) Gets the current count of audio sample rate supported.
long	SampleRate	Gets or sets the desired sample rate.
long	BitsPerSampleSupportedCount	(Read-only) Gets the current count of bits / sample supported.
long	BitsPerSample	Gets or sets the bits per sample.

Interface Methods:

HRESULT GetBitrateSupported(long index, long* pVal);

Parameters

index	Index of desired bitrate value.
pVal	Pointer to the long value representing the returned bitrate.

Description

Gets the supported bitrate value at the specified index. The value returned is measured in kilobits/second. For example, a value of 192 means 192 kbps.

Returns

S_OK if successful, < 0 if an error occurred.

HRESULT IsBitrateSupported(long bitrate, VARIANT_BOOL* pVal);

Parameters

bitrate	A long value representing the bitrate to check. The bitrate should be in kilobits/second.
pVal	Pointer to the VARIANT_BOOL value indicating whether or not the bitrate is supported.

Description

Checks the specified bitrate for support.

Returns

S_OK if successful, < 0 if an error occurred.

Common Error Codes

E_POINTER [0x80004003] pVal is NULL

HRESULT GetChannelsSupported(long index, long* pVal);

Parameters

index	Index to the channel type.
pVal	Pointer to the long variable to receive the channel type value supported at the given index.

Description

Gets the long value representing the audio channels type supported for the specified index, given the current audio stream bitrate.

Possible values are: 1=Mono, 2=Stereo, 6=5.1 Surround, 8=7.1 Surround.

Returns

S_OK if successful, < 0 if an error occurred.

Common Error Codes

E_POINTER [0x80004003] pVal is NULL
E_INVALIDARG [0x80070057] Index is invalid

HRESULT IsChannelsSupported(long channels, VARIANT_BOOL* pVal);

Parameters

channels	A long value indicating the desired channel type value. 1=Mono, 2=Stereo, 6=5.1 Surround, 8=7.1 Surround.
pVal	Pointer to the VARIANT_BOOL value indicating whether or not the channels is supported.

Description

Gets a boolean value indicating whether or not the current audio stream and bit rate support the desired channel type.

Returns

S_OK if successful, < 0 if an error occurred.

HRESULT GetSampleRateSupported(long index, long* pVal);

Parameters

index	Index to the sample rate.
pVal	Pointer to the long variable to receive the sample rate value supported at the given index.

Description

Gets the long value representing the sample rate for the specified index, given the current audio stream bitrate.

Returns

S_OK if successful, < 0 if an error occurred.

Common Error Codes

E_POINTER [0x80004003] pVal is NULL
E_INVALIDARG [0x80070057] Index is invalid

HRESULT IsSampleRateSupported(long sampleRate, VARIANT_BOOL* pVal);

Parameters

sampleRate	A long value indicating the sample rate to check.
pVal	Pointer to the VARIANT_BOOL value indicating whether or not the sample rate is supported.

Description

Gets a boolean value indicating whether or not the current audio stream and bit rate support the sample rate.

Returns

S_OK if successful, < 0 if an error occurred.

HRESULT GetBitsPerSampleSupported(long index, long* pVal);

Parameters

index	Index to the bits per sample.
pVal	Pointer to the long variable to receive the bits per sample value supported at the given index.

Description

Gets the long value representing the bits per sample for the sample rates associated with the current channel type for the specified index, given the current audio stream bitrate.

Returns

S_OK if successful, < 0 if an error occurred.

Common Error Codes

E_POINTER [0x80004003] pVal is NULL
E_INVALIDARG [0x80070057] Index is invalid

HRESULT IsBitsPerSampleSupported(long bitsPerSample, VARIANT_BOOL* pVal);

Parameters

sampleRate	A long value indicating the bits per sample to check.
pVal	Pointer to the VARIANT_BOOL value indicating whether or not the bits per sample is supported.