From 44f4845df3a7abeb89f5154b70fbe9722bff645d Mon Sep 17 00:00:00 2001 From: Jonathan Marler Date: Mon, 6 Mar 2023 09:02:57 -0700 Subject: [PATCH] clarify that buffers remain alive until the remove_buffer callback returns In order for stream buffers to be captured and then processed by other threads, pipewire needs to guarantee that the buffer will remain alive until the application is notified of its removal. In this case pipewire uses the "remove_buffer" callback to notify the application that a buffer is about to be removed, so pipewire must guarantee that it is alive up to that point. --- src/pipewire/stream.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pipewire/stream.h b/src/pipewire/stream.h index 04b31ffca..d30de667a 100644 --- a/src/pipewire/stream.h +++ b/src/pipewire/stream.h @@ -122,7 +122,7 @@ extern "C" { * metadata of the buffer. * * The buffer is owned by the stream and stays alive until the - * remove_buffer event is emitted or the stream is destroyed. + * remove_buffer callback has returned or the stream is destroyed. * * When the buffer has been processed, call \ref pw_stream_queue_buffer() * to let PipeWire reuse the buffer.