output/Interface: add method ChangeAudioFormat()
This is just the API design; there is no implementation yet, and no caller.
This commit is contained in:
parent
86a37d0ed6
commit
ba41690063
@ -105,6 +105,28 @@ public:
|
|||||||
*/
|
*/
|
||||||
virtual void Close() noexcept = 0;
|
virtual void Close() noexcept = 0;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Attempt to change the #AudioFormat. After successful
|
||||||
|
* return, the caller may invoke Play() with the new format.
|
||||||
|
* If necessary, the method should drain old data from its
|
||||||
|
* buffers.
|
||||||
|
*
|
||||||
|
* If this method fails, the caller may then attempt to
|
||||||
|
* Close() and Open() the object instead.
|
||||||
|
*
|
||||||
|
* Throws on error. After such a failure, this object is in
|
||||||
|
* an undefined state, and it must be closed.
|
||||||
|
*
|
||||||
|
* @param audio_format the audio format in which data is going
|
||||||
|
* to be delivered; may be modified by the plugin
|
||||||
|
* @return true on success, false if the operation is not
|
||||||
|
* supported/implemented (no-op and the old format may still
|
||||||
|
* be used)
|
||||||
|
*/
|
||||||
|
virtual bool ChangeAudioFormat(AudioFormat &) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Returns a positive number if the output thread shall further
|
* Returns a positive number if the output thread shall further
|
||||||
* delay the next call to Play() or Pause(), which will happen
|
* delay the next call to Play() or Pause(), which will happen
|
||||||
|
Loading…
Reference in New Issue
Block a user