> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XTaskQueueMonitorCallback

> XTaskQueueMonitorCallback

# XTaskQueueMonitorCallback

每当提交任务以供执行时由任务队列调用的回调。

<a id="syntaxSection" />

## Syntax

```cpp theme={null}
void XTaskQueueMonitorCallback(  
         void* context,  
         XTaskQueueHandle queue,  
         XTaskQueuePort port  
)  
```

<a id="parametersSection" />

### Parameters

*context*   \_In\_opt\_\
类型：void\*

传递给 [XTaskQueueRegisterMonitor](/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor) 的上下文指针。

*queue*   \_In\_\
类型：XTaskQueueHandle

向其提交任务的任务队列。

*port*   \_In\_\
类型：[XTaskQueuePort](/reference/system/xtaskqueue/enums/xtaskqueueport)

向其提交任务的端口。

<a id="retvalSection" />

### Return value

类型：void

无。

<a id="remarksSection" />

## Remarks

`XTaskQueueMonitorCallback` 表示打算与 [XTaskQueueRegisterMonitor](/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor) 函数一起使用的回调。如果向任务队列注册了 `XTaskQueueMonitorCallback` 回调，则每当通过 [XTaskQueueSubmitCallback](/reference/system/xtaskqueue/functions/xtaskqueuesubmitcallback) 或 [XTaskQueueSubmitDelayedCallback](/reference/system/xtaskqueue/functions/xtaskqueuesubmitdelayedcallback) 向任务队列提交任务时，都会调用此回调。有关实现 `XTaskQueueMonitorCallback` 回调的详细信息，请参阅[如何：使用事件控制手动队列调度](/build/core-features/common/async/async-task-queue-design-howto/control-manual-queue-dispatching)。

<a id="requirementsSection" />

## Requirements

**头文件：** XTaskQueue.h

**库：** xgameruntime.lib

**受支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

<a id="seealsoSection" />

## See also

[异步编程模型](/build/core-features/common/async/async-programming-model)\
[异步任务队列设计](/build/core-features/common/async/async-task-queue-design)\
[XTaskQueue 库概述](/build/core-features/common/async/async-libraries/async-library-xtaskqueue)\
[XTaskQueue 成员](/reference/system/xtaskqueue/xtaskqueue_members)


## Related topics

- [XTaskQueueUnregisterMonitor](/zh-CN/reference/system/xtaskqueue/functions/xtaskqueueunregistermonitor.md)
- [XTaskQueueRegisterMonitor](/zh-CN/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md)
- [XTaskQueueTerminatedCallback](/zh-CN/reference/system/xtaskqueue/functions/xtaskqueueterminatedcallback.md)
- [XTaskQueuePort](/zh-CN/reference/system/xtaskqueue/enums/xtaskqueueport.md)
- [XTaskQueue](/zh-CN/reference/system/xtaskqueue/xtaskqueue_members.md)