Packet Sniffer SDK DLL Edition

HNQueue :: Methods :: QueReturnFreeItem

 Previous Next

Returns HNPacket element with Free status back to the queue.

Syntax:

void __stdcall QueReturnFreeItem(HANDLE hQue, HANDLE hPacket);

Parameters:

hQue

[in] HNQueue object handle.

hPacket

[in] HNPacket object handle.

Description:

Use QueReturnFreeItem to return free HNPacket object back to the queue after it is used by your application.

After QueReturnFreeItem is executed FreeCount [Get] property will be changed. Also, if another thread was awaiting for QueGetFreeItem function completion, its status will be changed.

After an HNPacket object is used, it must be returned back to the queue as soon as possible: these objects will be used repeatedly by the adapter connected to the queue.
See also:HNQueue, QueGetFreeCount, QueGetFreeItem, QueGetFullItem