ISpatialAudioObjectRenderStreamBase::Start method (spatialaudioclient.h)

Starts the spatial audio stream.


HRESULT Start();

Return value

If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.

Return code Description
The audio stream has not been stopped. Stop the stream by calling Stop.
The ISpatialAudioClient associated with the spatial audio stream has been destroyed.
The audio endpoint device has been unplugged, or the audio hardware or associated hardware resources have been reconfigured, disabled, removed, or otherwise made unavailable for use.
An internal error has occurred.
The media associated with the spatial audio stream uses an unsupported format.


Starting the stream causes data flow between the endpoint buffer and the audio engine.
The first time this method is called, the stream's audio clock position will be at 0.
Otherwise, the clock resumes from its position at the time that the stream was last paused with a call to Stop.
Call Reset to reset the clock position to 0 and cause all active ISpatialAudioObject instances to be revoked.

The stream must have been previously stopped with a call to Stop or the method will fail and return SPTLAUDCLNT_E_STREAM_NOT_STOPPED.


Target Platform Windows
Header spatialaudioclient.h

See also