(Page 10 of 11 in this chapter) Version


hmiStatusReq

Description

Retrieves the current HMI service status and statistics.

Prototype

DWORD hmiStatusReq (CTAHD ctahd,
HmStatsData *pHmStats,
U8 reset)

ctahd CT Access handle from a previous successful call to ctaOpenServices.

pHmStats Pointer to a statistics structure, should be local to application memory. See Details.

reset If set to zero, do not reset counters. If non-zero, reset all counters.

Return Values

Details

Statistics structures to which the pHmStats parameter may point are provided here.

typedef struct hmLnkStats
{
  U32 txHB;      /* number of link heartbeat messages transmitted   */
  U32 rxHB;      /* number of link heartbeat messages received      */
  U8  linkState; /* state of the IBC link, see hmidef.h             */
  U8  fill;
} HmLnkStats;


typedef struct hmTskStats
{
  U32 txLnkStInd;  /* number of link state change ind. transmitted     */
  U32 txRunStInd;  /* number of task state change ind. transmitted     */
  U32 rxHB;        /* number of link heartbeat mesg recvd from task    */
  U8  runState;    /* run state of task,incl HMRS_FAILED, see hmidef.h */
  U8  rxSeq;       /* RX sequence number                               */
  U8  txSeq;       /* TX sequence number                               */
  U8  remRunState; /* run state of remote task of same name            */
  U8  name[8];     /* task name                                        */
} HmTskStats;


typedef struct hmStatsData
{
  HmLnkStats linkStats;              /* statistics for the IBC link    */
  U8         numTsks;                /* number of tasks with statistics
                                        reported                       */
  U8         fill;    
  HmTskStats taskStats[HM_MAXTASKS]; /* task statistics                */
} HmStatsData;


(Page 10 of 11 in this chapter) Version


tech_support@nmss.com
Copyright © 2000, Natural MicroSystems, Inc. All rights reserved.