QUIC Configuration Interface

docs/API.md

@@ -33,9 +33,7 @@ The API supports both server and client applications. All functionality is expos
 
 [**Registration**](#registration) – Manages the execution context for all child objects. An app may open multiple registrations but ideally should only open one.
 
-[**Security Configuration**](#security-configuration) – Abstracts the configuration for the TLS component. This primarily consists of a certificate that is used for authentication. The app may create as many of these as necessary.
-
-[**Session**](#session) – Abstracts several different session-layer concepts: TLS Session Resumption, Application Layer Protocol Negotiation (ALPN) and platform specifics (such as Server Silo and Network Compartment ID on Windows). The app may create as many of these as necessary.
+[**Configuration**](#configuration) – Abstracts the configuration for a connection. TODO
 
 [**Listener**](#listener) – Server side only, this object provides the interface for an app to accept incoming connections from clients. Once the connection has been accepted, it is independent of the listener. The app may create as many of these as necessary.
 
@@ -88,17 +86,11 @@ Generally, each app only needs a single registration. The registration represent
 
 A registration is created by calling [RegistrationOpen](api/RegistrationOpen.md) and deleted by calling [RegistrationClose](api/RegistrationClose.md).
 
-## Security Configuration
-
-Currently only used on the server side, the security configuration (AKA security config) abstracts a server certificate (and other configuration) used by a [listener](#listener) to accept an incoming connection request.
-
-A security config is created by calling [SecConfigCreate](api/SecConfigCreate.md) and deleted by calling [SecConfigDelete](api/SecConfigDelete.md).
-
-## Session
+## Configuration
 
-An app must create a session before it can create any listeners or connections. Each session maintains certain transport and platform state common to all child handles. Primarily, this consists of the ALPN string used for the connection handshakes and TLS state used for session resumption. On Windows platforms it also inherits the Silo and Network Compartment ID from the thread that creates it.
+TODO
 
-A session is created by calling [SessionOpen](api/SessionOpen.md) and deleted by calling [SessionClose](api/SessionClose.md). [SessionClose](api/SessionClose.md) **will block** on all oustanding connections. Therefore do not call it on any MsQuic event callback, as it will likely create a deadlock.
+A configuration is created by calling [ConfigurationOpen](api/ConfigurationOpen.md) and deleted by calling [ConfigurationClose](api/ConfigurationClose.md).
 
 ## Listener
 

docs/api/ConfigurationClose.md

@@ -0,0 +1,29 @@
+ConfigurationClose function
+======
+
+Deletes an existing security configuration.
+
+# Syntax
+
+```C
+typedef
+_IRQL_requires_max_(PASSIVE_LEVEL)
+void
+(QUIC_API * QUIC_CONFIGURATION_CLOSE_FN)(
+    _In_ _Pre_defensive_ __drv_freesMem(Mem)
+        HQUIC Configuration
+    );
+```
+
+# Parameters
+
+**TODO**
+
+# Remarks
+
+**TODO**
+
+# See Also
+
+[ConfigurationOpen](ConfigurationOpen.md)<br>
+[ConfigurationLoadCredential](ConfigurationLoadCredential.md)<br>

docs/api/ConfigurationLoadCredential.md

@@ -0,0 +1,29 @@
+ConfigurationLoadCredential function
+======
+
+Deletes an existing configuration.
+
+# Syntax
+
+```C
+typedef
+_IRQL_requires_max_(PASSIVE_LEVEL)
+QUIC_STATUS
+(QUIC_API * QUIC_CONFIGURATION_LOAD_CREDENTIAL_FN)(
+    _In_ _Pre_defensive_ HQUIC Configuration,
+    _In_ _Pre_defensive_ const QUIC_CREDENTIAL_CONFIG* CredConfig
+    );
+```
+
+# Parameters
+
+**TODO**
+
+# Remarks
+
+**TODO**
+
+# See Also
+
+[ConfigurationOpen](ConfigurationOpen.md)<br>
+[ConfigurationClose](ConfigurationClose.md)<br>

docs/api/ConfigurationOpen.md

@@ -0,0 +1,45 @@
+ConfigurationOpen function
+======
+
+Creates a new configuration.
+
+# Syntax
+
+```C
+typedef
+_IRQL_requires_max_(PASSIVE_LEVEL)
+QUIC_STATUS
+(QUIC_API * QUIC_CONFIGURATION_OPEN_FN)(
+    _In_ _Pre_defensive_ HQUIC Registration,
+    _In_reads_(AlpnBufferCount) _Pre_defensive_
+        const QUIC_BUFFER* const AlpnBuffers,
+    _In_range_(>, 0) uint32_t AlpnBufferCount,
+    _In_reads_bytes_opt_(SettingsSize)
+        const QUIC_SETTINGS* Settings,
+    _In_ uint32_t SettingsSize,
+    _In_opt_ void* Context,
+    _Outptr_ _At_(*Configuration, __drv_allocatesMem(Mem)) _Pre_defensive_
+        HQUIC* Configuration
+    );
+```
+
+# Parameters
+
+`Registration`
+
+The valid handle to an open registration object.
+
+**TODO**
+
+# Return Value
+
+The function returns a [QUIC_STATUS](QUIC_STATUS.md). The app may use `QUIC_FAILED` or `QUIC_SUCCEEDED` to determine if the function failed or succeeded.
+
+# Remarks
+
+**TODO**
+
+# See Also
+
+[ConfigurationClose](ConfigurationClose.md)<br>
+[ConfigurationLoadCredential](ConfigurationLoadCredential.md)<br>

docs/api/ConnectionOpen.md

@@ -10,7 +10,8 @@ typedef
 _IRQL_requires_max_(DISPATCH_LEVEL)
 QUIC_STATUS
 (QUIC_API * QUIC_CONNECTION_OPEN_FN)(
-    _In_ _Pre_defensive_ HQUIC Session,
+    _In_ _Pre_defensive_ HQUIC Registration,
+    _In_ _Pre_defensive_ HQUIC Configuration,
     _In_ _Pre_defensive_ QUIC_CONNECTION_CALLBACK_HANDLER Handler,
     _In_opt_ void* Context,
     _Outptr_ _At_(*Connection, __drv_allocatesMem(Mem)) _Pre_defensive_
@@ -20,9 +21,13 @@ QUIC_STATUS
 
 # Parameters
 
-`Session`
+`Registration`
 
-The valid handle to an open session object.
+The valid handle to an open registration object.
+
+`Configuration`
+
+The valid handle to an open configuration object.
 
 `Handler`
 

docs/api/GetContext.md

@@ -18,7 +18,7 @@ void*
 
 `Handle`
 
-The valid handle to any API object. This includes handles to registration, session, listener, connection and stream objects.
+The valid handle to any API object. This includes handles to registration, configuration, listener, connection and stream objects.
 
 # Return Value
 

docs/api/GetParam.md

@@ -25,7 +25,7 @@ QUIC_STATUS
 
 `Handle`
 
-The valid handle to any API object. This includes handles to registration, session, listener, connection and stream objects. For `Level` equal to `QUIC_PARAM_LEVEL_GLOBAL`, this parameter must be `NULL`.
+The valid handle to any API object. This includes handles to registration, configuration, listener, connection and stream objects. For `Level` equal to `QUIC_PARAM_LEVEL_GLOBAL`, this parameter must be `NULL`.
 
 `Level`
 

docs/api/ListenerOpen.md

@@ -10,7 +10,7 @@ typedef
 _IRQL_requires_max_(PASSIVE_LEVEL)
 QUIC_STATUS
 (QUIC_API * QUIC_LISTENER_OPEN_FN)(
-    _In_ _Pre_defensive_ HQUIC Session,
+    _In_ _Pre_defensive_ HQUIC Registration,
     _In_ _Pre_defensive_ QUIC_LISTENER_CALLBACK_HANDLER Handler,
     _In_opt_ void* Context,
     _Outptr_ _At_(*Listener, __drv_allocatesMem(Mem)) _Pre_defensive_

docs/api/ListenerStart.md

@@ -11,6 +11,9 @@ _IRQL_requires_max_(PASSIVE_LEVEL)
 QUIC_STATUS
 (QUIC_API * QUIC_LISTENER_START_FN)(
     _In_ _Pre_defensive_ HQUIC Listener,
+    _In_reads_(AlpnBufferCount) _Pre_defensive_
+        const QUIC_BUFFER* const AlpnBuffers,
+    _In_range_(>, 0) uint32_t AlpnBufferCount,
     _In_opt_ const QUIC_ADDR* LocalAddress
     );
 ```

docs/api/QUIC_API_TABLE.md

@@ -17,13 +17,12 @@ typedef struct QUIC_API_TABLE {
 
     QUIC_REGISTRATION_OPEN_FN           RegistrationOpen;
     QUIC_REGISTRATION_CLOSE_FN          RegistrationClose;
+    QUIC_REGISTRATION_SHUTDOWN_FN       RegistrationShutdown;
 
-    QUIC_SEC_CONFIG_CREATE_FN           SecConfigCreate;
-    QUIC_SEC_CONFIG_DELETE_FN           SecConfigDelete;
-
-    QUIC_SESSION_OPEN_FN                SessionOpen;
-    QUIC_SESSION_CLOSE_FN               SessionClose;
-    QUIC_SESSION_SHUTDOWN_FN            SessionShutdown;
+    QUIC_CONFIGURATION_OPEN_FN          ConfigurationOpen;
+    QUIC_CONFIGURATION_CLOSE_FN         ConfigurationClose;
+    QUIC_CONFIGURATION_LOAD_CREDENTIAL_FN
+                                        ConfigurationLoadCredential;
 
     QUIC_LISTENER_OPEN_FN               ListenerOpen;
     QUIC_LISTENER_CLOSE_FN              ListenerClose;
@@ -34,6 +33,7 @@ typedef struct QUIC_API_TABLE {
     QUIC_CONNECTION_CLOSE_FN            ConnectionClose;
     QUIC_CONNECTION_SHUTDOWN_FN         ConnectionShutdown;
     QUIC_CONNECTION_START_FN            ConnectionStart;
+    QUIC_CONNECTION_SEND_RESUMPTION_FN  ConnectionSendResumptionTicket;
 
     QUIC_STREAM_OPEN_FN                 StreamOpen;
     QUIC_STREAM_CLOSE_FN                StreamClose;
@@ -78,25 +78,21 @@ See [RegistrationOpen](RegistrationOpen.md)
 
 See [RegistrationClose](RegistrationClose.md)
 
-`SecConfigCreate`
-
-See [SecConfigCreate](SecConfigCreate.md)
-
-`SecConfigDelete`
+`RegistrationShutdown`
 
-See [SecConfigDelete](SecConfigDelete.md)
+See [RegistrationShutdown](RegistrationShutdown.md)
 
-`SessionOpen`
+`ConfigurationOpen`
 
-See [SessionOpen](SessionOpen.md)
+See [ConfigurationOpen](ConfigurationOpen.md)
 
-`SessionClose`
+`ConfigurationClose`
 
-See [SessionClose](SessionClose.md)
+See [ConfigurationClose](ConfigurationClose.md)
 
-`SessionShutdown`
+`ConfigurationLoadCredential`
 
-See [SessionShutdown](SessionShutdown.md)
+See [ConfigurationLoadCredential](ConfigurationLoadCredential.md)
 
 `ListenerOpen`
 

docs/api/RegistrationClose.md

@@ -23,7 +23,7 @@ A registration handle from a previous call to [RegistrationOpen](RegistrationOpe
 
 # Remarks
 
-The application **must** close/delete all child security configurations and session objects before closing the registration. This call **will block** on those outstanding objects being cleaned up. Do no call it on any MsQuic event callback, or it will deadlock.
+The application **must** close/delete all child configurations and connection objects before closing the registration. This call **will block** on those outstanding objects being cleaned up. Do no call it on any MsQuic event callback, or it will deadlock.
 
 # See Also
 

docs/api/SessionShutdown.md → docs/api/RegistrationShutdown.md

@@ -1,26 +1,26 @@
-SessionShutdown function
+RegistrationShutdown function
 ======
 
-Starts the shutdown process for all connections in the session.
+Starts the shutdown process for all connections in the registration.
 
 # Syntax
 
 ```C
 typedef
-_IRQL_requires_max_(PASSIVE_LEVEL)
+_IRQL_requires_max_(DISPATCH_LEVEL)
 void
-(QUIC_API * QUIC_SESSION_SHUTDOWN_FN)(
-    _In_ _Pre_defensive_ HQUIC Session,
+(QUIC_API * QUIC_REGISTRATION_SHUTDOWN_FN)(
+    _In_ _Pre_defensive_ HQUIC Registration,
     _In_ QUIC_CONNECTION_SHUTDOWN_FLAGS Flags,
     _In_ _Pre_defensive_ QUIC_UINT62 ErrorCode // Application defined error code
     );
 ```
 
 # Parameters
 
-`Session`
+`Registration`
 
-The valid handle to an open session object.
+The valid handle to an open registration object.
 
 `Flags`
 
@@ -41,6 +41,6 @@ The 62-bit error code to indicate to the peer as the reason for the shutdown.
 
 # See Also
 
-[SessionOpen](SessionOpen.md)<br>
-[SessionClose](SessionClose.md)<br>
+[RegistrationOpen](RegistrationOpen.md)<br>
+[RegistrationClose](RegistrationClose.md)<br>
 [ConnectionShutdown](ConnectionShutdown.md)<br>