Returns the handle of HNQueue object.

Syntax:

HANDLE __stdcall FAdpGetQueue(HANDLE hFAdp);

Parameters:

hFAdp

[in] HNFileAdapter object handle.

Return values:

If the function succeeds the return value will be the HNQueue handle, otherwise the returned value is NULL.

Description:

Use FAdpGetQueue to check the HNFileAdapter.Queue property of HNFileAdapter object.

HNFileAdapter component interacts immediately with HNQueue component using HNFileAdapter.Queue property. Thanks to the cutting down amount of packets data copying operations, this approach allows to work with CAP files by the most powerful way.

Assume, you're going to capture traffic from the network adapter and immediately dump it to a CAP file.

In process of the traffic capture the packets queue elements are used by HNAdapter component immediately. By redirecting of the packets flow to the HNFileAdapter component and using of HNQueue, you also can dump captured traffic to a CAP file almost immediately, meantime you can use all advantages of the asynchronous packets processing provided by HNQueue component.

To change HNFileAdapter.Queue property value please use FAdpSetQueue function.