disabletimer.c

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

/*
* File			:	RZKDisableTimer.c
*
* Description	:	This file contains the RZKDisableTimer function which 
*					disables the timer
* 
* 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 "ZTimer.h"
#include "ZInterrupt.h"

#define pTimer ((RZK_TIMER_t *) hTimer)

/** extern functions */
extern void UpdateTQ1OnRemove(RZK_TCB_t *pObjectToRemove);

/** extern variables */
extern RZK_THREADHANDLE_t hCurrentThread;

/*
* Function		:	RZKDisableTimer
*
* Description	:	This function disables a software timer and brings 
*					it back to the dormant state
* 
* Inputs		:	hTimer - handle to timer 
*
* Outputs		:	RZKERR_INVALID_HANDLE - handle of the timer object is invalid.
*					RZKERR_CB_BUSY - timer control block is being exclusively used by another object.
*					RZKERR_SUCCESS - timer object is disabled
*
* Dependencies	:	None
*/

RZK_STATUS_t RZKDisableTimer
				(
				RZK_TIMERHANDLE_t hTimer
				)
{
	RZK_STATE_t uState;
	#ifdef RZK_DEBUG
		if((pTimer==NULL)||(pTimer->magic_num != MAGIC_NUM_TIMER) || (pTimer -> uState == 0))
			return RZKERR_INVALID_HANDLE;
	#endif

#ifndef RZK_PERFORMANCE
	if(!(pTimer -> uState & OBJECT_CREATED))
		return RZKERR_CB_BUSY;
#endif

	if(pTimer->uState & TIMER_DISABLE)
		return RZKERR_INVALID_OPERATION;

	/* set the disable bit in the uState */
	uState = RZKDisablePreemption();
	UpdateTQ1OnRemove((RZK_TCB_t *)pTimer);
	pTimer -> uState |= TIMER_DISABLE ;
	RZKRestorePreemption(uState);
	return RZKERR_SUCCESS;
}	 /* end of RZKDisableTimer */