Synth Filter Sample
|Microsoft DirectShow 9.0|
The Synth filter is a source filter that generates audio waveforms.
This sample is included with the Windows SDK. It is located under the following path: [SDK Root]\Samples\Multimedia\DirectShow\Filters\Synth.
This filter illustrates dynamic graph building. It can switch between uncompressed PCM audio and compressed MS_ADPCM (Microsoft Adaptive Delta Pulse Code Modulation) format.
This filter appears in GraphEdit as "Audio Synthesizer Filter."
For more information about dynamic graph building, see Dynamic Graph Building.
The Synth filter enables the user to set the waveform, frequency, number of channels, and other properties through the property page. To set either the upper or lower endpoint of the swept frequency range, hold down SHIFT while adjusting the frequency slider. The filter also supports a custom interface, ISynth2, for setting these properties.
To demonstrate the dynamic graph building feature, do the following:
- Build the filter and register it with the Regsvr32 utility.
- Launch GraphEdit.
- Insert the Audio Synthesizer filter. It appears in the DirectShow Filters category.
- Render the filter's output pin.
- Click the Play button.
- Open the filter's property page.
- In the Output Format area, select PCM or Microsoft ADPCM.
This sample contains the following files:
- Dynsrc.h, Dynsrc.cpp: Contains two base classes for source filters that support dynamic graph building, CDynamicSource and CDynamicSourceStream.
- ISynth.h: Declares the custom ISynth2 interface for setting properties on the filter.
- Resource.h: Contains resource constants.
- Synth.def: Exports the DLL functions needed by the COM library.
- Synth.h, Synth.cpp: Contains the CAudioSynth class, which generates the audio data, and the CSynthFilter class, which implements the filter.
- Synth.rc: Contains resources used by the filter.
- Synthprp.h, Synthprp.cpp: Implements the filter's property page.
The CDynamicSource class is adapted from the CSource base class. It uses one or more output pins derived from the CDynamicSourceStream class. The CDynamicSourceStream class is adapted from the CSourceStream class, but derives from the CDynamicOutputPin class rather than the CBaseOutputPin class.
The CDynamicSource class has the following methods not found in CSource:
- Stop: Signals the stop event (CDynamicOutputPin::m_hStopEvent), and shuts down the worker thread for all unconnected pins. On a connected pin, the pin's Inactive method will shut down the worker thread.
- Pause: Resets the stop event.
- JoinFilterGraph: Calls the CDynamicOutputPin::SetConfigInfo method on each pin.
The CDynamicSourceStream class has the following methods not found in CSourceStream:
- DestroySourceThread: Shuts down the worker thread.
- FatalError: Signals an error to the filter graph manager.
- OutputPinNeedsToBeReconnected: Signals that the output pin should be reconnected. When this method is called, the worker thread calls the CDynamicOutputPin::DynamicReconnect method to reconnect the pin.