CTransformInputPin.CheckMediaType method

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The CheckMediaType method determines if the pin accepts a specific media type.

Syntax

HRESULT CheckMediaType(
   const CMediaType *mtIn
);

Parameters

mtIn

Pointer to a CMediaType object that contains the proposed media type.

Return value

Returns S_OK or another HRESULT value.

Remarks

This method implements the pure virtual CBasePin::CheckMediaType method. It calls the filter's CTransformFilter::CheckInputType method, which is also pure virtual. The filter's derived class must implement CheckInputType to determine whether a given input type is acceptable.

If the filter's output pin is connected, this method also calls the filter's CTransformFilter::CheckTransform method to determine whether the input type is compatible with the output type. The CheckTransform method is pure virtual as well.

Requirements

Requirement Value
Header
Transfrm.h (include Streams.h)
Library
Strmbase.lib (retail builds);
Strmbasd.lib (debug builds)