Microsoft DirectX 8.1 (C++)

IAMTimelineGroup::SetSmartRecompressFormat

The SetSmartRecompressFormat method specifies a compression format to use for smart recompression.

Smart recompression is not supported for audio groups.

Syntax

HRESULT SetSmartRecompressFormat(
    long *pFormat
);

Parameters

pFormat

Pointer to a structure describing the compression format. Currently, only the SCompFmt0 structure is valid. You must cast this parameter to a pointer of type long.

Return Value

Returns one of the following HRESULT values:

Return code Description
S_OK Success.
E_POINTER NULL pointer argument.
E_INVALIDARG Invalid argument.

Remarks

Before calling this method, call the IAMTimelineGroup::SetMediaType method on the same group, to specify an uncompressed format. The compressed and uncompressed formats must have the same width, height, and frame rate. If these values do not match, the group output pin produces uncompressed output instead of compressed output.

This method overwrites any frame rate value that was set using the IAMTimelineGroup::SetOutputFPS method.

The smart recompression format is not persistent. If an application uses smart recompression, it must set the recompression format whenever it loads a project file.

See Also