@@ -2541,11 +2541,6 @@ HEADERS have END_STREAM set. The <em>stream_user_data</em> is data
associated to the stream opened by this request and can be an
arbitrary pointer, which can be retrieved later by
<aclass="reference internal"href="#c.nghttp2_session_get_stream_user_data"title="nghttp2_session_get_stream_user_data"><ttclass="xref c c-func docutils literal"><spanclass="pre">nghttp2_session_get_stream_user_data()</span></tt></a>.</p>
<p>This function returns assigned stream ID if it succeeds. But that
stream is not opened yet. The application must not submit frame to
that stream ID before
<aclass="reference internal"href="#c.nghttp2_session_callbacks.before_frame_send_callback"title="nghttp2_session_callbacks.before_frame_send_callback"><ttclass="xref c c-member docutils literal"><spanclass="pre">nghttp2_session_callbacks.before_frame_send_callback</span></tt></a> is
called for this frame.</p>
<p>This function returns assigned stream ID if it succeeds, or one of
the following negative error codes:</p>
<dlclass="docutils">
...
...
@@ -2555,6 +2550,14 @@ the following negative error codes:</p>
<dd>No stream ID is available because maximum stream ID was
reached.</dd>
</dl>
<divclass="admonition warning">
<pclass="first admonition-title">Warning</p>
<pclass="last">This function returns assigned stream ID if it succeeds. But
that stream is not opened yet. The application must not submit
frame to that stream ID before
<aclass="reference internal"href="#c.nghttp2_session_callbacks.before_frame_send_callback"title="nghttp2_session_callbacks.before_frame_send_callback"><ttclass="xref c c-member docutils literal"><spanclass="pre">nghttp2_session_callbacks.before_frame_send_callback</span></tt></a> is
called for this frame.</p>
</div>
</dd></dl>
<dlclass="function">
...
...
@@ -2632,11 +2635,6 @@ stream state from idle or reserved to open.</p>
<p>This function is low-level in a sense that the application code can
specify flags directly. For usual HTTP request,
<aclass="reference internal"href="#c.nghttp2_submit_request"title="nghttp2_submit_request"><ttclass="xref c c-func docutils literal"><spanclass="pre">nghttp2_submit_request()</span></tt></a> is useful.</p>
<p>This function returns assigned stream ID if it succeeds and
<em>stream_id</em> is -1. But that stream is not opened yet. The
application must not submit frame to that stream ID before
<aclass="reference internal"href="#c.nghttp2_session_callbacks.before_frame_send_callback"title="nghttp2_session_callbacks.before_frame_send_callback"><ttclass="xref c c-member docutils literal"><spanclass="pre">nghttp2_session_callbacks.before_frame_send_callback</span></tt></a> is
called for this frame.</p>
<p>This function returns newly assigned stream ID if it succeeds and
<em>stream_id</em> is -1. Otherwise, this function returns 0 if it
succeeds, or one of the following negative error codes:</p>
...
...
@@ -2647,6 +2645,14 @@ succeeds, or one of the following negative error codes:</p>
<dd>No stream ID is available because maximum stream ID was
reached.</dd>
</dl>
<divclass="admonition warning">
<pclass="first admonition-title">Warning</p>
<pclass="last">This function returns assigned stream ID if it succeeds and
<em>stream_id</em> is -1. But that stream is not opened yet. The
application must not submit frame to that stream ID before
<aclass="reference internal"href="#c.nghttp2_session_callbacks.before_frame_send_callback"title="nghttp2_session_callbacks.before_frame_send_callback"><ttclass="xref c c-member docutils literal"><spanclass="pre">nghttp2_session_callbacks.before_frame_send_callback</span></tt></a> is
called for this frame.</p>
</div>
</dd></dl>
<dlclass="function">
...
...
@@ -2762,11 +2768,6 @@ make it in reserved state. It is available using
<aclass="reference internal"href="#c.nghttp2_session_get_stream_user_data"title="nghttp2_session_get_stream_user_data"><ttclass="xref c c-func docutils literal"><spanclass="pre">nghttp2_session_get_stream_user_data()</span></tt></a>. The application can
access it in <aclass="reference internal"href="#c.nghttp2_before_frame_send_callback"title="nghttp2_before_frame_send_callback"><ttclass="xref c c-type docutils literal"><spanclass="pre">nghttp2_before_frame_send_callback</span></tt></a> and
<aclass="reference internal"href="#c.nghttp2_on_frame_send_callback"title="nghttp2_on_frame_send_callback"><ttclass="xref c c-type docutils literal"><spanclass="pre">nghttp2_on_frame_send_callback</span></tt></a> of this frame.</p>
<p>This function returns assigned promised stream ID if it succeeds.
But that stream is not opened yet. The application must not submit
frame to that stream ID before
<aclass="reference internal"href="#c.nghttp2_session_callbacks.before_frame_send_callback"title="nghttp2_session_callbacks.before_frame_send_callback"><ttclass="xref c c-member docutils literal"><spanclass="pre">nghttp2_session_callbacks.before_frame_send_callback</span></tt></a> is
called for this frame.</p>
<p>The client side is not allowed to use this function.</p>
<p>This function returns assigned promised stream ID if it succeeds,
or one of the following negative error codes:</p>
...
...
@@ -2780,6 +2781,14 @@ client.</dd>
<dd>No stream ID is available because maximum stream ID was
reached.</dd>
</dl>
<divclass="admonition warning">
<pclass="first admonition-title">Warning</p>
<pclass="last">This function returns assigned promised stream ID if it succeeds.
But that stream is not opened yet. The application must not
submit frame to that stream ID before
<aclass="reference internal"href="#c.nghttp2_session_callbacks.before_frame_send_callback"title="nghttp2_session_callbacks.before_frame_send_callback"><ttclass="xref c c-member docutils literal"><spanclass="pre">nghttp2_session_callbacks.before_frame_send_callback</span></tt></a> is