Function libnghttp2_sys::nghttp2_session_set_local_window_size

pub unsafe extern "C" fn nghttp2_session_set_local_window_size(
    session: *mut nghttp2_session, 
    flags: u8, 
    stream_id: i32, 
    window_size: i32
) -> c_int

@function

Set local window size (local endpoints's window size) to the given |window_size| for the given stream denoted by |stream_id|. To change connection level window size, specify 0 to |stream_id|. To increase window size, this function may submit WINDOW_UPDATE frame to transmission queue.

The |flags| is currently ignored and should be :enum:NGHTTP2_FLAG_NONE.

This sounds similar to nghttp2_submit_window_update(), but there are 2 differences. The first difference is that this function takes the absolute value of window size to set, rather than the delta. To change the window size, this may be easier to use since the application just declares the intended window size, rather than calculating delta. The second difference is that nghttp2_submit_window_update() affects the received bytes count which has not acked yet. By the specification of nghttp2_submit_window_update(), to strictly increase the local window size, we have to submit delta including all received bytes count, which might not be desirable in some cases. On the other hand, this function does not affect the received bytes count. It just sets the local window size to the given value.

This function returns 0 if it succeeds, or one of the following negative error codes:

:enum:NGHTTP2_ERR_INVALID_ARGUMENT The |stream_id| is negative. :enum:NGHTTP2_ERR_NOMEM Out of memory.