Update libdvrtracking doc
Explicitly states the ownership of the DvrWriteBufferQueue handle.
Bug: 109710161
Test: header only, build system.
Change-Id: Ida6b8d8b99a62cfa8de4d348ce0edc243a296baa
(cherry picked from commit 5e520122df1d93f12b449aa2ed127dc85d9fdf4b)
diff --git a/libs/vr/libdvr/include/dvr/dvr_tracking.h b/libs/vr/libdvr/include/dvr/dvr_tracking.h
index b5591a0..5e388f3 100644
--- a/libs/vr/libdvr/include/dvr/dvr_tracking.h
+++ b/libs/vr/libdvr/include/dvr/dvr_tracking.h
@@ -59,7 +59,10 @@
// populate the buffer into. The queue must be empty and the camera stack
// will request buffer allocation with proper buffer dimension, format, and
// usage. Note that the write queue must be created with user_metadata_size
-// set to sizeof(DvrTrackingBufferMetadata).
+// set to sizeof(DvrTrackingBufferMetadata). On success, the write_queue
+// handle will become invalid and the ownership of the queue handle will be
+// transferred into the camera; otherwise, the write_queue handle will keep
+// untouched and the caller still has the ownership.
// @return Zero on success, or negative error code.
int dvrTrackingCameraStart(DvrTrackingCamera* camera,
DvrWriteBufferQueue* write_queue);