pcTimerGetName
[定时器 API]

 const char * pcTimerGetName( TimerHandle_t xTimer );

返回软件定时器的人类可读文本名称。

将文本名称分配给定时器需使用 调用 xTimerCreate() 函数的 pcTimerName 参数， 该函数用于创建定时器。

参数：

xTimer

被查询的定时器。

返回：

指向定时器文本名称的指针，该指针为以 NULL 结尾的标准 C 字符串。

const char *pcTimerName = "ExampleTimer";

/* A function that creates a timer. */
static void prvCreateTimer( void )
{
TimerHandle_t xTimer;

    /* Create a timer. */
    xTimer = xTimerCreate( pcTimerName,           /* Text name. */
                           pdMS_TO_TICKS( 500 ),  /* Period. */
                           pdTRUE,                /* Autoreload. */
                           NULL,                  /* No ID. */
                           prvExampleCallback );  /* Callback function. */

    if( xTimer != NULL )
    {
        xTimerStart( xTimer, portMAX_DELAY );

        /* Just to demonstrate pcTimerGetName(), query the timer's name and
        assert if it does not equal pcTimerName. */
        configASSERT( strcmp( pcTimerGetName( xTimer ), pcTimerName ) == 0 );
    }
}