IltmmTargetFormat::get_RecommendedAudioCompressor

#include "ltmm.h"

C Syntax	HRESULT IltmmTargetFormat__get_RecommendedAudioCompressor(Format, pVal)
C++ Syntax	HRESULT get_RecommededAudioCompressor(pVal)

IltmmTargetFormat *Format;	/* pointer to an interface */
BSTR *pVal;	/* pointer to a string */

Retrieves the recommended audio compressor Also known as an encoder Also known as compressor, this is a module or algorithm to compress data. Playing that data back requires a decompressor, or decoder., this is a module or algorithm to compress data. Playing that data back requires a decompressor Also known as a decoder, this is a module or algorithm to decompress data., or decoder Also known as a decompressor, this is a module or algorithm to decompress data.. for the currently selected target format The format to be used for the converted file. This includes the file format, any special settings used by that format, and which audio and/or video codec A COmpressor combined with a DECompressor, or encoder and a decoder, which allows you to both compress and decompress that same data. is to be used for the conversion, and any special settings used by the codecs..

Parameter	Description
Format	Pointer to an IltmmTargetFormat interface.
pVal	Pointer to a variable that will receive the name of the recommended audio compressor for the currently selected target format.

Returns

S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

Currently, the toolkit does not recommend compressors for all formats, so if the returned string is empty, then there is no recommended audio compressor for the selected target format.

If the method succeeds, the caller must free the returned BSTR by calling the SysFreeString function.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Elements:	IltmmTargetFormat::IsValid Compressor, IltmmTargetFormat::get_RecommendedVideoCompressor
Topics:	Multimedia Function Group