IFWXIOCompletion Interface

Article
08/13/2010

The IFWXIOCompletion interface includes a method that receives a notification from the Microsoft Firewall service when an asynchronous I/O send, sendto, or receive operation is completed on an IFWXSocket interface. These overlapped operations require that the filter implement this interface to carry out data pumping.

For more information about how the IFWXIOCompletion interface is used in application filters, see Filter Object Model.

Syntax

interface IFWXIOCompletion : IUnknown

When To Implement

An application filter that initiates overlapped operations by calling the asynchronous methods on an IFWXSocket interface must implement this notification interface.

Methods

The IFWXIOCompletion interface inherits the methods of the IUnknown interface.

In addition, IFWXIOCompletion defines the following method.

Method	Description
CompleteAsyncIO	Receives a notification from the Firewall service when an asynchronous I/O operation that was initiated on an IFWXSocket interface completes.

Remarks

When calling a method that begins an overlapped operation, the filter must pass a pointer to its IFWXIOCompletion interface to that method. The Firewall service calls CompleteAsyncIO on the IFWXIOCompletion interface of the filter when the overlapped operation completes.

Forefront TMG has two other notification methods for overlapped operations. The IFWXExternalIOCompletion::CompleteAsyncIO notification method is used for notification when a Windows overlapped operation completes, and the IFWXAcceptCompletion::CompleteAsyncAccept method is used for notification when the IFWXNetworkSocket::Accept method completes.

Requirements

Server	Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2.
Version	Requires Forefront Threat Management Gateway (TMG) 2010.
Header	Declared in Wspfwext.idl.

Share via