diff --git a/docs/api/ConnectionOpen.md b/docs/api/ConnectionOpen.md index d73876c03..06c5508a8 100644 --- a/docs/api/ConnectionOpen.md +++ b/docs/api/ConnectionOpen.md @@ -47,7 +47,13 @@ The function returns a [QUIC_STATUS](QUIC_STATUS.md). The app may use `QUIC_FAIL # Remarks -**TODO** +`ConnectionOpen` is used to create a connection in the client application. In server applications, [ListenerOpen](ListenerOpen.md) and [ListenerStart](ListenerStart.md) must be called to listen for incoming connection attempts, and the server side Connection is created in the `QUIC_LISTENER_EVENT_NEW_CONNECTION` event. + +'ConnectionOpen' only allocates the resources for the connection, it does not start the connection. To start the connect, the application must call [ConnectionStart](ConnectionStart.md). + +Once `ConnectionOpen` completes successfully, the application may create streams, and queue data for sending. This is when 0-RTT streams and data **MUST** be created and queued. See [StreamOpen](StreamOpen.md), and [StreamStart](StreamStart.md). + +Once the connection has been shutdown, it must be cleaned up with a call to [ConnectionClose](ConnectionClose.md). # See Also