Returns HNPacket elements with Free status back to the queue.

Syntax:

void __stdcall QueReturnFreeItems(HANDLE hQue, PHANDLE hPackets, DWORD dwCount);

Parameters:

hQue

[in] HNQueue object handle.

hPackets

[in] Array of HNPacket objects handles.

dwCount

[in] Size of array of HNPacket objects handles (see hPackets parameter). Means maximal quantity of objects, which hPackets parameter may contain.

Description:

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

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

After an HNPacket objects is used, these objects must be returned back to the queue as soon as possible: these objects will be used repeatedly by the adapter connected to the queue.