Update httpsys-delegation.md

Author: guardrex

aspnetcore/fundamentals/servers/yarp/httpsys-delegation.md

@@ -1,30 +1,34 @@
 ---
 uid: fundamentals/servers/yarp/httpsys-delegation
-title: YARP Http.sys Delegation
-description: YARP Http.sys Delegation
+title: YARP HTTP.sys Delegation
+description: YARP HTTP.sys Delegation
 author: samsp-msft
 ms.author: samsp
 ms.date: 2/6/2025
 ms.topic: article
 content_well_notification: AI-contribution
 ai-usage: ai-assisted
 ---
-
-# YARP Http.sys Delegation
+# YARP HTTP.sys Delegation
 
 ## Introduction
-Http.sys delegation is a kernel level feature added into newer versions of Windows which allows a request to be transferred from the receiving process's http.sys queue to a target process's http.sys queue with very little overhead or added latency. For this delegation to work, the receiving process is only allowed to read the request headers. If the body has started to be read or a response has started, trying to delegate the request will fail. The response will not be visible to the proxy after delegation, which limits the functionality of the session affinity and passive health checks components, as well as some of the load balancing algorithms. Internally, YARP leverages ASP.NET Core's [IHttpSysRequestDelegationFeature](/dotnet/api/microsoft.aspnetcore.server.httpsys.ihttpsysrequestdelegationfeature) 
+
+HTTP.sys delegation is a kernel level feature added into newer versions of Windows which allows a request to be transferred from the receiving process's HTTP.sys queue to a target process's HTTP.sys queue with very little overhead or added latency. For this delegation to work, the receiving process is only allowed to read the request headers. If the body has started to be read or a response has started, trying to delegate the request will fail. The response will not be visible to the proxy after delegation, which limits the functionality of the session affinity and passive health checks components, as well as some of the load balancing algorithms. Internally, YARP leverages ASP.NET Core's [IHttpSysRequestDelegationFeature](/dotnet/api/microsoft.aspnetcore.server.httpsys.ihttpsysrequestdelegationfeature) 
 
 ## Requirements
-Http.sys delegation requires:
-- [ASP.NET Core's Http.sys server](/aspnet/core/fundamentals/servers/httpsys)
-- Windows Server 2019 or Windows 10 (build number 1809) or newer.
+
+HTTP.sys delegation requires:
+
+* [ASP.NET Core's HTTP.sys server](/aspnet/core/fundamentals/servers/httpsys)
+* Windows Server 2019 or Windows 10 (build number 1809) or newer.
 
 ## Defaults
-Http.sys delegation won't be used unless added to the proxy pipeline and enabled in the destination configuration. 
+
+HTTP.sys delegation won't be used unless added to the proxy pipeline and enabled in the destination configuration. 
 
 ## Configuration
-Http.sys delegation can be enabled per destination by adding the `HttpSysDelegationQueue` metadata to the destination. The value of this metadata should be the target http.sys queue name. The destination's Address is used to specify the url prefix of the http.sys queue.
+
+HTTP.sys delegation can be enabled per destination by adding the `HttpSysDelegationQueue` metadata to the destination. The value of this metadata should be the target HTTP.sys queue name. The destination's Address is used to specify the url prefix of the HTTP.sys queue.
 
 ```json
 {
@@ -53,31 +57,35 @@ Http.sys delegation can be enabled per destination by adding the `HttpSysDelegat
 }
 ```
 
-In host configuration, configure the host to use the Http.sys server.
-```c#
+In host configuration, configure the host to use the HTTP.sys server:
+
+```csharp
 webBuilder.UseHttpSys();
 ```
 
-In application configuration, use the `MapReverseProxy` overload that lets you customize the pipeline and add http.sys delegation by calling `UseHttpSysDelegation`.
-```c#
+In application configuration, use the `MapReverseProxy` overload that allows you to customize the pipeline and add HTTP.sys delegation by calling `UseHttpSysDelegation`:
+
+```csharp
 app.MapReverseProxy(proxyPipeline =>
 {
-    // Add the three middleware YARP adds by default plus the Http.sys delegation middleware
-    proxyPipeline.UseSessionAffinity(); // Has no affect on delegation destinations
+    // Add the three middleware YARP adds by default plus the HTTP.sys
+    // delegation middleware
+    proxyPipeline.UseSessionAffinity(); // No affect on delegation destinations
     proxyPipeline.UseLoadBalancing();
     proxyPipeline.UsePassiveHealthChecks();
     proxyPipeline.UseHttpSysDelegation();
 });
 ```
 
-## Delegation Queue Lifetime
-When YARP is configured to use delegation for a destination, a handle is created to the specified http.sys queue. This handle is kept alive as long as the destinations referencing it exist. Clean up of these handles is done during GC, so it's possible cleanup of the handle is delayed if it ends up in Gen2. This may cause issues for some receivers during process restart because if they try to create the queue during startup it will fail (because it still exists since YARP has a handle to it). The receivers need to be smart enough to attach instead and properly re-setup the queue. ASP.NET Core's http.sys server [has this issue](https://github.com/dotnet/aspnetcore/issues/40359).
+## Delegation queue lifetime
+
+When YARP is configured to use delegation for a destination, a handle is created to the specified HTTP.sys queue. This handle is kept alive as long as the destinations referencing it exist. Clean up of these handles is done during GC, so it's possible cleanup of the handle is delayed if it ends up in Gen2. This may cause issues for some receivers during process restart because if they try to create the queue during startup it fails because it still exists since YARP has a handle to it. The receivers must be smart enough to attach instead and properly re-setup the queue. ASP.NET Core's HTTP.sys server has this issue. For more information, see [Http.sys server should support setting up URL groups when attaching to an existing queue (`dotnet/aspnetcore` #40359)](https://github.com/dotnet/aspnetcore/issues/40359).
 
-YARP exposes a way to reset its handle to the queue. This allows consumers to write custom logic to determin if/when the handle to the queue should be cleaned up.
+YARP exposes a way to reset its handle to the queue. This allows consumers to write custom logic to determine when the handle to the queue should be cleaned up.
 
 Example:
 
-```c#
+```csharp
 var delegator = app.Services.GetRequiredService<IHttpSysDelegator>();
 delegator.ResetQueue("TargetHttpSysQueueName", "http://*:80");
 ```