IotDeQueue_RemoveAllMatches

Remove all matching elements from a queue.

static inline void IotDeQueue_RemoveAllMatches( const IotDeQueue_t * const pQueue,
                                                bool ( * isMatch )( const IotLink_t * const pOperationLink, void * pCompare ),
                                                void * pMatch,
                                                void ( * freeElement )( void * pData ),
                                                size_t linkOffset )

Parameters

[in]	pQueue	The queue to search.
[in]	isMatch	Function to determine if an element matches. Pass NULL to search using the address pMatch, i.e. element == pMatch.
[in]	pMatch	If isMatch is NULL, each element in the queue is compared to this address to find a match. Otherwise, it is passed as the second argument to isMatch.
[in]	freeElement	A function to free memory used by each removed queue element. Optional; pass NULL to ignore.
[in]	linkOffset	Offset in bytes of a link member in its container, used to calculate the pointer to pass to freeElement. This value should be calculated with the C offsetof macro. This parameter is ignored if freeElement is NULL or its value is 0.