TsgcWebSocketServer_HTTPAPIProperties › FineTune

FineTune Property

Low-level kernel-mode knobs that shape how http.sys queues, dispatches and completes requests.

Syntax

public TsgcServerHTTPAPI_FineTune FineTune { get; set; }

Default Value

QueueLength=1000, SkipIOCPOnSuccess=False, OperatingMode=ompClassic, HighPerfAcceptsPerWorker=4

Remarks

QueueLength is the kernel request-queue depth (HttpServerQueueLengthProperty); once full, http.sys replies 503 Service Unavailable without involving user mode — raise it to absorb reconnect bursts (up to 65535). SkipIOCPOnSuccess enables FILE_SKIP_COMPLETION_PORT_ON_SUCCESS on the request queue so synchronous successes dispatch inline without an IOCP packet (ignored on Windows XP). OperatingMode chooses between ompClassic (single acceptor thread + PostQueuedCompletionStatus, historical behaviour) and ompHighPerf (Microsoft's MSDN HP pattern: no acceptor, ThreadPoolSize x HighPerfAcceptsPerWorker pre-posted async receives on the queue-bound IOCP); only change before activation. HighPerfAcceptsPerWorker (default 4) widens the pre-posted receive window for high-concurrency workloads — each pre-posted receive holds a ReadBufferSize-sized buffer until it completes. See the HTTPAPI FineTune guide for a full discussion.

Example

Back to Properties