diff --git a/include/grpc/grpc.h b/include/grpc/grpc.h index 7869e9272e2..2f43199f5ad 100644 --- a/include/grpc/grpc.h +++ b/include/grpc/grpc.h @@ -589,9 +589,13 @@ grpc_call_error grpc_call_cancel_with_status(grpc_call *call, THREAD SAFETY: grpc_call_destroy is thread-compatible */ void grpc_call_destroy(grpc_call *call); -/** Request notification of a new call. 'cq_for_notification' must - have been registered to the server via - grpc_server_register_completion_queue. */ +/** Request notification of a new call. + Once a call with the given \a tag_new (or NULL for any tag) is received in + \a cq_bound_to_call, a notification is added to \a cq_for_notification and + \a call, \a details and \a request_metadata are updated with the appropriate + call information. + Note that \a cq_for_notification must have been registered to the server via + \a grpc_server_register_completion_queue. */ grpc_call_error grpc_server_request_call( grpc_server *server, grpc_call **call, grpc_call_details *details, grpc_metadata_array *request_metadata,