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 at http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wmform11/htm/iwmcodecinfogetcodecformat.asp.
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. |
See Also
|
Elements: |
IltmmWMProfileManager::GetCodecInfoCount, IltmmWMProfileManager::GetCodecFormatCount, IltmmWMProfileManager::GetCodecName, IltmmWMProfileManager::GetCodecFormatDesc |
|
Topics: |
|
|
|
Example
For a C example, refer to IltmmWMProfile::AddStream Example for C.
For a C++ example, refer to IltmmWMProfile::AddStream Example for C++.