Packet Sniffer SDK DLL Edition

HNQueue :: Methods :: QueReturnFullItems

 Previous Next

Returns HNPacket elements with Full status back to the queue.

Syntax:

void __stdcall QueReturnFullItems(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 QueReturnFullItems to return free HNPacket objects back to the queue after it is used by your application.

After QueReturnFullItems is executed FullCount [Get] property will be changed. Also, if another thread was awaiting for QueGetFullItem(QueGetFullItems) function completion, its status will be changed.

If there are HNPacket objects non-returned to the queue, then after deleting of queue element or releasing queue resources by QueFreeItems function memory access errors may occur if you use such objects.
See also:HNQueue, QueGetFullCount, QueGetFreeItem, QueGetFreeItems, QueGetFullItem, QueGetFullItems