Microsoft Windows CE 3.0  

CBasePin::Inactive

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.

Switches the pin to an inactive state.

virtual HRESULT Inactive(void);

Return Values

Returns NOERROR for a base class implementation. The overriding member function returns a standard HRESULTvalue and should not fail if the pin is already 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 any hardware resources that were obtained in the CBasePin::Activecall. The default implementation of the base class member function does nothing.

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