Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

Switches the pin to an inactive state.

Syntax

virtual HRESULT Inactive(void);

Parameters

None.

Return Value

Returns NOERROR for a base class implementation.

The overriding member function returns a standard HRESULTvalue and should not fail if the pin is set as inactive.

Remarks

This member function is called by the IMediaFilterimplementation when the state changes to inactive.

This member function should be overridden to decommit allocators and free hardware resources obtained in the CBasePin::Activecall.

The default implementation of the base class member function does nothing.

The filter graph manager's internal state variable is not updated until after this member function returns, so avoid testing the filter graph manager's state (directly or indirectly) from within this member function.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment,
Version 2.12 requires DXPAK 1.0 or later