Skip to main content

RegisterLampArrayCallback

注册一个回调函数,每次 LampArray 从系统连接或断开时都会调用它。

语法

参数

lampArrayCallback   _In_ 类型:LampArrayCallback 要注册的、由调用方定义的函数。每当 LampArrays 从系统连接或断开时都会调用它。 context   _In_opt_
类型:void*
指向包含回调函数相关信息的对象的指针。通常,这是调用对象。 callbackToken   _Out_ _Result_zeroonfailure_ 类型:LampArrayCallbackToken* 可用于以后取消注册该回调函数的令牌值。

返回值

类型:HRESULT 函数结果。

备注

如果在注册回调时有任何 LampArray 设备处于连接状态,RegisterLampArrayCallback 函数将阻塞,直到对每个已连接设备都调用了该回调(这意味着回调将在调用线程上执行)。 在注册第一个回调时,LampArray API 会启动一个工作线程来处理 ILampArray 设备的连接和断开通知。这些事件并不频繁,工作线程在其他时间保持等待状态。注册调用返回后,所有后续的 LampArrayCallbacks 将在此工作线程上按顺序执行。 以下代码是注册和取消注册 LampArray 回调的示例:

要求

头文件: LampArray.h 库: xgameplatform.lib 支持的平台: XBOX One 系列主机和 XBOX Series 主机

另请参阅

光照 API 概览
光照基础
LampArrayCallback
UnregisterLampArrayCallback
最后修改于 2026年8月24日