Pārlūkot izejas kodu

Merge pull request #2234 from soltanmm/doc

Clarify caller contract for grpc_call_start_batch
Craig Tiller 10 gadi atpakaļ
vecāks
revīzija
a7661b59d8
1 mainītis faili ar 3 papildinājumiem un 1 dzēšanām
  1. 3 1
      include/grpc/grpc.h

+ 3 - 1
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.
    completion of type 'tag' to the completion queue bound to the call.
    The order of ops specified in the batch has no significance.
    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
    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
    THREAD SAFETY: access to grpc_call_start_batch in multi-threaded environment
    needs to be synchronized. As an optimization, you may synchronize batches
    needs to be synchronized. As an optimization, you may synchronize batches
    containing just send operations independently from batches containing just
    containing just send operations independently from batches containing just