RegisterLampArrayStatusCallback
注册一个回调函数,每次 LampArray 状态发生变化时都会调用它。语法
参数
callbackFunc _In_ 类型:LampArrayStatusCallback 要注册的、由调用方定义的函数。每当 LampArray 状态发生变化时都会调用它。 enumerationKind类型:LampArrayEnumerationKind 指定 LampArrayStatusCallback 函数所期望的设备枚举行为。 context _In_opt_
类型:void* 指向包含回调函数相关信息的对象的指针。通常,这是调用对象。 callbackToken _Out_ _Result_zeroonfailure_ 类型:LampArrayCallbackToken* 可用于以后取消注册该回调函数的令牌值。
返回值
类型:HRESULT 函数结果。备注
LampArrayEnumerationKind 参数允许调用方指定如何为在调用时已连接的 LampArray 设备接收回调。如果选择 LampArrayEnumerationKind::Blocking,RegisterLampArrayStatusCallback 函数将阻塞,直到对每个已连接设备都调用了该回调(这意味着回调将在调用线程上执行)。 在注册第一个回调时,LampArray API 会启动一个工作线程来处理 ILampArray 设备状态通知。这些事件并不频繁,工作线程在其他时间保持等待状态。注册调用返回后,所有后续的 LampArrayStatusCallbacks 将在此工作线程上按顺序执行。 如果指定 LampArrayEnumerationKind::Async,此调用会立即返回,且调用时已连接的任何 LampArrays 将在前述 LampArray 回调工作线程上进行枚举。 以下代码是注册和取消注册 LampArrayStatusCallback 函数的示例:要求
头文件: LampArray.h 库: xgameplatform.lib 支持的平台: XBOX One 系列主机和 XBOX Series 主机另请参阅
光照 API 概览光照基础
LampArrayStatusCallback
UnregisterLampArrayCallback
LampArrayEnumerationKind
