ISpatialAudioObjectRenderStreamBase::Start method (spatialaudioclient.h)

Starts the spatial audio stream.

Syntax

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
SPTLAUDCLNT_E_STREAM_NOT_STOPPED
The audio stream has not been stopped. Stop the stream by calling Stop.
SPTLAUDCLNT_E_DESTROYED
The ISpatialAudioClient associated with the spatial audio stream has been destroyed.
AUDCLNT_E_DEVICE_INVALIDATED
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.
SPTLAUDCLNT_E_INTERNAL
An internal error has occurred.
AUDCLNT_E_UNSUPPORTED_FORMAT
The media associated with the spatial audio stream uses an unsupported format.

Remarks

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.

Requirements

Requirement Value
Target Platform Windows
Header spatialaudioclient.h

See also

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase