CTransformFilter::Transform

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Performs transform operations of the filter.

Syntax

virtual HRESULT Transform(
  IMediaSample* pIn,
  IMediaSample* pOut
) PURE;

Parameters

• pIn
  Pointer to the input IMediaSample interface.

• pOut
  Pointer to the output IMediaSample interface.

Return Value

The overriding member function returns an HRESULT value. If it returns S_FALSE, the default implementation of the sample will not be delivered by the default implementation of the CTransformFilter::Receive member function.

Remarks

The CTransformFilter::Receive member function calls this member function, which must be overridden with a member function that implements the transform intended for the filter.

Perform your transform operation in the implementation of this member function, reading the data from the input IMediaSample interface and writing the data to the output IMediaSample interface.

The member function returns when the transform is complete, without releasing or delivering either of the samples.

Change properties on the output sample if they are not the same as the input sample. For example, change the start and stop time IMediaSample::SetTime), sample status flags (IMediaSample::IsSyncPoint), and so on.

Requirements