From b70b70956d11ab909d92129be63fbc42ec06ff74 Mon Sep 17 00:00:00 2001 From: Masood Malekghassemi Date: Fri, 26 Jun 2015 16:25:11 -0700 Subject: Clarify caller contract for grpc_call_start_batch --- include/grpc/grpc.h | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/include/grpc/grpc.h b/include/grpc/grpc.h index 8b4676562b..637f473b82 100644 --- a/include/grpc/grpc.h +++ b/include/grpc/grpc.h @@ -396,7 +396,9 @@ grpc_call *grpc_channel_create_registered_call( completion of type 'tag' to the completion queue bound to the call. The order of ops specified in the batch has no significance. Only one operation of each type can be active at once in any given - batch. + batch. You must call grpc_completion_queue_next or + grpc_completion_queue_pluck on the completion queue associated with 'call' + for work to be performed. THREAD SAFETY: access to grpc_call_start_batch in multi-threaded environment needs to be synchronized. As an optimization, you may synchronize batches containing just send operations independently from batches containing just -- cgit v1.2.3