Share via


IDirectMusicSynthSink interface (dmusics.h)

The IDirectMusicSynthSink interface is now largely obsolete and is supported only by versions of DirectMusic before DirectX 8. This interface represents a streaming wave device that pulls audio from the DirectMusic software synthesizer. By separating the functionality of IDirectMusicSynth from that of IDirectMusicSynthSink, a DirectMusic application can take the output of any synthesizer and feed it to an audio device of its choosing. IDirectMusicSynthSink inherits from the IUnknown interface.

By default, the wave data generated by the software synth is handled by DirectMusic's internal synth sink, which feeds the wave data into DirectSound. For more information, see IDirectMusicSynth and IDirectMusicSynthSink.

In addition to the methods that IDirectMusicSynthSink inherits from the IUnknown interface, IDirectMusicSynthSink supports the following methods:

IDirectMusicSynthSink::Activate

IDirectMusicSynthSink::GetDesiredBufferSize

IDirectMusicSynthSink::GetLatencyClock

IDirectMusicSynthSink::Init

IDirectMusicSynthSink::RefTimeToSample

IDirectMusicSynthSink::SampleToRefTime

IDirectMusicSynthSink::SetDirectSound

IDirectMusicSynthSink::SetMasterClock

Inheritance

The IDirectMusicSynthSink interface inherits from the IUnknown interface.

Methods

The IDirectMusicSynthSink interface has these methods.

 
IDirectMusicSynthSink::Activate

The Activate method activates or deactivates the synthesizer sink.
IDirectMusicSynthSink::GetDesiredBufferSize

The GetDesiredBufferSize method retrieves the synthesizer's preferred buffer size, expressed in samples.
IDirectMusicSynthSink::GetLatencyClock

The GetLatencyClock method retrieves the latency clock, which measures the progress of the output audio stream.
IDirectMusicSynthSink::Init

The Init method initializes the synth-sink object.
IDirectMusicSynthSink::RefTimeToSample

The RefTimeToSample method converts a reference time to a sample time.
IDirectMusicSynthSink::SampleToRefTime

The SampleToRefTime method converts a sample time to a reference time.
IDirectMusicSynthSink::SetDirectSound

The SetDirectSound method connects the synthesizer sink with an existing DirectSound object and a DirectSound buffer.
IDirectMusicSynthSink::SetMasterClock

The SetMasterClock method provides the synth sink with a master time source, which is required for synchronization with the rest of DirectMusic.

Requirements

Requirement Value
Target Platform Windows
Header dmusics.h