Microsoft DirectX 8.0

IDecimateVideoImage Interface

The IDecimateVideoImage interface specifies decimation on a decoder filter. The term decimation refers to scaling the video output down to a size smaller than the native size of the video.

Applications must not call methods on this interface. The Overlay Mixer filter uses this interface to decimate video at the video decoder.

Decoder filters that can decimate their video output should support this interface.

Methods in Vtable Order

IUnknown methodsDescription
QueryInterfaceRetrieves pointers to supported interfaces.
AddRefIncrements the reference count.
ReleaseDecrements the reference count.
IDecimateVideoImage methodsDescription
SetDecimationImageSizeSpecifies the dimensions to which the decoder should decimate its output image.
ResetDecimationImageSizeSpecifies that the decoder should no longer decimate its output image.

IDecimateVideoImage::ResetDecimationImageSize

IDecimateVideoImage Interface

Specifies that the decoder should no longer decimate its output image.

Syntax

HRESULT ResetDecimationImageSize(void);

Return Value

Returns an HRESULT value indicating the success or failure of the call.

IDecimateVideoImage::SetDecimationImageSize

IDecimateVideoImage Interface

Specifies the dimensions to which the decoder should decimate its output image.

Syntax

HRESULT SetDecimationImageSize(
    long lWidth,
    long lHeight
);

Parameters

lWidth
[in] Width of the video image, in pixels.
lHeight
[in] Height of the video image, in pixels.

Return Value

Returns one of the following HRESULT values.

E_FAILThe decoder cannot perform any decimation, or needs to halt decimation it is currently performing.
S_OKThe decoder can decimate the video to the requested size.