IltmmWMProfileManager::GetCodecFormat

#include "ltmm.h"

C Syntax

HRESULT IltmmWMProfileManager__getCodecFormat(pProfMan, Type, CodecIndex, FormatIndex, pVal)

C++ Syntax

HRESULT GetCodecFormat(Type, CodecIndex, FormatIndex, pVal)

 

IltmmWMProfileManager *pProfMan;

/* pointer to an interface */

BSTR Type;

/* string */

long CodecIndex;

/* index */

long FormatIndex;

/* index */

IltmmWMStreamConfig **pVal;

/* pointer to a pointer */

Gets the format at the specified format index, which is supported by the codec A COmpressor Also known as an encoder, this is a module or algorithm to compress data. Playing that data back requires a decompressor, or decoder. combined with a DECompressor, or encoder Also known as compressor, this is a module or algorithm to compress data. Playing that data back requires a decompressor, or decoder. and a decoder Also known as a decompressor, this is a module or algorithm to decompress data., which allows you to both compress and decompress that same data. at the specified codec index.

Parameter

Description

pProfMan

Pointer to an IltmmWMProfileManager interface.

Type

A string identifying the major media type for which the specified format is retrieved. Possible values are:

 

Value

 

ltmmMEDIATYPE_Video

 

ltmmMEDIATYPE_Audio

CodecIndex

The zero based index of the codec for which to retrieve the specified format.

FormatIndex

The zero based index of the format to retrieve.

pVal

Pointer to a variable to be updated with a pointer to an IltmmWMStreamConfig interface. This interface describes the retrieved 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

If IltmmWMProfileManager::GetCodecFormat succeeds, the caller must free the retrieved interface by calling its Release method.

For more information, refer to the Microsoft documentation for IWMCodecInfo::GetCodecFormat .

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.

Platforms

Win32, x64

See Also

Elements:

IltmmWMProfileManager::GetCodecInfoCount, IltmmWMProfileManager::GetCodecFormatCount, IltmmWMProfileManager::GetCodecName, IltmmWMProfileManager::GetCodecFormatDesc

Topics:

Multimedia Function Group

 

Windows Media Support

Example

For a C example, refer to IltmmWMProfile::AddStream Example for C.

For a C++ example, refer to IltmmWMProfile::AddStream Example for C++.