Microsoft Internet Security and Acceleration Server 2004 SDK

IFWXIOCompletion

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.

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 in Vtable Order

The IFWXIOCompletion interface inherits the methods of the standard COM interface IUnknown.

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.

ISA Server 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 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wspfwext.idl.

See Also

Filter Interfaces, IFWXSocket::Recv, IFWXSocket::Send, IFWXSocket::SendTo