IMediaDet::put_Filter

  • Article
 
Microsoft DirectShow 9.0

IMediaDet::put_Filter

The put_Filter method specifies a source filter for the media detector to use.

  • **Important   **Do not add the source filter to your own filter graph, or use a filter that is already in a filter graph. The media detector object automatically builds an internal filter graph, and putting the filter in another graph can cause unexpected results.

Syntax

  HRESULT put_Filter(
    IUnknown *newVal
);

Parameters

newVal

[in] Pointer to the source filter's IUnknown interface.

Return Value

Returns an HRESULT value. Possible values include the following:

Value Description
S_OK Success.
E_NOINTERFACE newVal does not point to a filter.
E_POINTER NULL pointer argument.

Remarks

For most applications, it is simpler to call the IMediaDet::put_Filename method with the name of a source file.

Requirements

Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.

Library: Use strmiids.lib.

See Also