文档队列

已更新 2025年6月

xQueueSendToFrontFromISR

[队列管理]

queue.h

1 BaseType_t xQueueSendToFrontFromISR
2 (
3 QueueHandle_t xQueue,
4 const void *pvItemToQueue,
5 BaseType_t *pxHigherPriorityTaskWoken
6 );

Copy

此宏用于调用 xQueueGenericSendFromISR() 函数。

将项目发布到队列头部。可以在中断服务程序中安全使用此函数。

项目通过复制而非引用的方式入队，因此最好只发送较小的项目， 或者发送指向该项目的指针。

参数：

• xQueue

  要向其中发布项目的队列的句柄。

• pvItemToQueue

  指向要放入队列中的项目的指针。队列能够存储的项目的大小 在创建队列时即已定义，因此 pvItemToQueue 中的这些字节将复制到 队列存储区中。

• pxHigherPriorityTaskWoken

  如果发送到队列会导致任务解除阻塞，并且解除阻塞的任务的优先级高于当前正在运行的任务， 则 xQueueSendToFrontFromISR() 会将 *pxHigherPriorityTaskWoken 设置为 pdTRUE。如果 xQueueSendToFrontFromISR() 将此值设置为 pdTRUE，则应在中断退出前请求上下文切换。 从 FreeRTOS V7.3.0 开始，pxHigherPriorityTaskWoken 为可选参数， 可设置为 NULL。

返回：

如果数据成功发送至队列，则返回 pdPass，否则返回 errQUEUE_FULL。

用法示例：

1void vBufferISR( void )
2{
3char cIn;
4BaseType_t xHigherPriorityTaskWoken;
5
6    /* We have not woken a task at the start of the ISR. */
7    xHigherPriorityTaskWoken = pdFALSE;
8
9    /* Obtain a byte from the buffer. */
10    cIn = portINPUT_BYTE( RX_REGISTER_ADDRESS );
11
12    if( cIn == EMERGENCY_MESSAGE )
13    {
14        /* Post the byte to the front of the queue. */
15        xQueueSendToFrontFromISR( xRxQueue, &cIn, &xHigherPriorityTaskWoken );
16    }
17    else
18    {
19        /* Post the byte to the back of the queue. */
20        xQueueSendToBackFromISR( xRxQueue, &cIn, &xHigherPriorityTaskWoken );
21    }
22
23    /* Did sending to the queue unblock a higher priority task? */
24    if( xHigherPriorityTaskWoken )
25    {
26        /* Actual macro used here is port specific. */
27        taskYIELD_FROM_ISR ();
28    }
29}

Copy