rzkdeleteeventgroup.c

zilog的实时操作系统RZK,可以移植到多种处理器上

/*
* File				:	RZKDeleteEventGroup
*
* Description		:	This file defines an API to delete an event group
* 
* Copyright 2004 ZiLOG Inc.  ALL RIGHTS RESERVED.
*
* This file contains unpublished confidential and proprietary information
* of ZiLOG, Inc.
* NO PART OF THIS WORK MAY BE DUPLICATED, STORED, PUBLISHED OR DISCLOSED 
* IN ANY FORM WITHOUT THE PRIOR WRITTEN CONSENT OF ZiLOG, INC.
* This is not a license and no use of any kind of this work is authorized
* in the absence of a written license granted by ZiLOG, Inc. in ZiLOG's 
* sole discretion 
*/
#include "ZSysgen.h"
#include "ZTypes.h"
#include "ZThread.h"
#include "ZQueue.h"
#include "ZEventgroup.h"
#include "externvar.h"
#include "ZScheduler.h"
#include "ZInterrupt.h"


#define pEventGroup  ((RZK_EVENTGROUP_t *) hEventGroup)

/** extern functions */
//extern void RZKScheduler();
//extern void UpdateThreadStatus( RZK_TCB_t * hThread, RZK_STATUS_t errNum); // IAR changed from UINT to RZK_STATUS_t

/* Function			:	RZKDeleteEventGroup
*
* Description		:	This function deletes an event group and invalidates
*						the control block
* 
* Inputs			:	hEventgroup - handle to Event Group
*							
* Outputs			:	RZKERR_SUCCESS - Event Group is successfully deleted
*						RZKERR_INVALID_HANDLE - handle is invalid
*						RZKERR_CB_BUSY - the object is being exclusively  used
*							
*
* Dependencies		:	None.
*/
RZK_STATUS_t RZKDeleteEventGroup
							(
							RZK_EVENTHANDLE_t hEventGroup
							)
{	
	/* Local Variables*/
	RZK_TCB_t *pTemp;
	RZK_STATE_t uState;
	/* validate the handle passed */
#ifdef RZK_DEBUG
		if((pEventGroup == NULL)||(pEventGroup -> uState == 0) || 
			(pEventGroup -> magic_num != MAGIC_NUM_EVENT))
		return RZKERR_INVALID_HANDLE;
#endif

	/* Invalidate the created bit of uState */
#ifndef RZK_PERFORMANCE
	if(!(pEventGroup -> uState & OBJECT_CREATED))
		return RZKERR_CB_BUSY;
#endif

		uState = RZKDisablePreemption();
		pEventGroup -> uState &=  ~(OBJECT_CREATED);
		
		 /* check the threads which are pending on the Event Group */
		pTemp = pEventGroup -> pResNext;
		while(pTemp != NULL)
		{
			/* Update each thread's status */
			UpdateThreadStatus(pTemp,RZKERR_OBJECT_DELETED);
			pTemp = pTemp -> pResNext;
		} /* end of while loop */

		/* Invalidate the Event Group by setting the uState
			parameter of the Event Group to 0 */
		pEventGroup -> uState = 0;
	
		RZKRestorePreemption(uState);
		return RZKERR_SUCCESS;

}	 /* end of RZKDeleteEventGroup */