ILMH264Decoder Interface

Show in webframe

ILMH264Decoder Interface is the interface for LEAD H264 Decoder.

Properties:

Type

Name

Description

long

DecodingOptions

Accepts one or all values from eH264DecodingFlag.

H264DecodingFlag_DecodeCorruptedStream:

Enables the decoder to play corrupted streams. The decoder will run slower in this mode.

H264DecodingFlag_DiscardCorruptedFrames:

When this option is enabled, the decoder will not deliver frames downstream frames it believes are corrupted. This results in cleaner looking video at a slightly lower frame rate in corrupted videos. This option is off by default.

H264DecodingFlag_DisplayGrayOnError:

Enables the decoder to display the corrupted data as a gray region. Otherwise a random area from previous frames could be displayed.

H264DecodingFlag_FillFrameGaps:

Enables the decoder to replace a missing frame from a previous frame in the stream. This option may provide jerky playback, and is not recommended

H264DecodingFlag_UseOneThread:

By default the number of threads the decoder uses equal to the number of CPU/cores. So for a quad core machine the decoder will use four threads to decode the h.264 stream. if this flag set, then the decoder will use one thread only no matter how many CPUs or cores the machine has.

H264DecodingFlag_WaitForI_FrameToPlay:

If set, the decoder will discard all the frames received before the first I frame. This will eliminate corrupted frames seen sometimes at the start of some streams. If not set, the decoder will display frames as soon as it receives them. This option is off by default.

double

DeliveredFrameNotificationInterval

The interval of Delivered Frame Notification in seconds. A value of Zero will disable notification sending. Values smaller than the time per frame (= 1.0 / frame rate) will cause the decoder to send a notification for each frame. The Notification ID is ltmmEC_Sample_Delivered. Values less than zero will not be accepted. This parameter can be changed while the decoder is running.

Method:

Name

Parameters

Description

WriteToRegistry

None

This method writes all of the decoder settings to the system registry. The next time the decoder is loaded, it retrieves the settings from the registry and applies them.

ResetToDefaultsEx

eH264DecoderApiLevel

ApiLevel

Resets decoder to default values. The ApiLevel determines which default values to use. Current applications should set ApiLevel to H264DecoderApiLevel_1 = 1.

The H264 decoder might change in the future and have different properties or default behaviour. Calling this method ensure the filter will have the same default values as they were at the time you developed your application.

It is recommended you call ResetToDefaultsEx(H264DecoderApiLevel_1) before you start setting properties and start calling other methods for this interface.

eH264DecodingFlag:

These are the possible values for H264 decoding flags. These flags can be set in the SymbolMode property.

typedef enum
{
   H264DecodingFlag_DecodeCorruptedStream = 0x00000001,
H264DecodingFlag_FillFrameGaps         = 0x00000002,
   H264DecodingFlag_DisplayGrayOnError    = 0x00000004,
   H264DecodingFlag_UseOneThread          = 0x00000008,
H264DecodingFlag_WaitForI_FrameToPlay = 0x00000010,
H264DecodingFlag_DiscardCorruptedFrames= 0x00000020,

} eH264DecodingFlag;

typedef enum
{
ltmmEC_Sample_Delivered = 0xA000,
} ltmmMediaEventCode_;

typedef enum
{
H264DecoderApiLevel_1 = 0
} eH264DecoderApiLevel;