StartHeavyBlockingOperation Method of the IFWXFirewall Interface

The StartHeavyBlockingOperation method notifies the Microsoft Firewall service that a thread is busy with a lengthy blocking operation.

Syntax

HRESULT StartHeavyBlockingOperation();

Parameters

This method has no parameters.

Return Value

S_OK

The method succeeded.

FWX_E_ALREADY_IN_BLOCKING_OP

The blocking operation is already started.

Remarks

The IFWXFirewall::StartHeavyBlockingOperation and IFWXFirewall::EndHeavyBlockingOperation methods manage the creation of additional completion port worker threads when all existing threads are blocked. The completion port model works best when all I/O operations are overlapped. When some calls are blocking, all worker threads may be blocked, and the service will be idle. When this method is used, the Firewall service keeps track of the number of threads that are busy with blocking operations and creates new threads when necessary.

Call the IFWXFirewall::StartHeavyBlockingOperation method before making a blocking operation such as a call to the gethostbyname function or reading (non-overlapped) from a file or a pipe. Call the IFWXFirewall::EndHeavyBlockingOperation method after the blocking call returns.

Do not call the IFWXFirewall::StartHeavyBlockingOperation method before waiting for a critical section or a resource on which other threads are likely to be blocked. If the newly created thread is blocked on the same critical section, there will be greater congestion on the critical section and more context switches, resulting in an overall reduction in performance.

Requirements

Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).
Header

Declared in Wspfwext.idl.

DLL

Requires Wspsrv.exe.

See Also

IFWXFirewall
IFWXFirewall::EndHeavyBlockingOperation


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.

508 Resource Limit Is Reached

Resource Limit Is Reached

The website is temporarily unable to service your request as it exceeded resource limit. Please try again later.