Skip to main content

RegisterLampArrayStatusCallback

Registra una función de devolución de llamada que se invocará cada vez que cambie el estado del LampArray.

Sintaxis

Parámetros

callbackFunc   _In_ Tipo: LampArrayStatusCallback Función definida por el autor de la llamada que se va a registrar. Se invocará cuando cambie el estado del LampArray. enumerationKind
Tipo: LampArrayEnumerationKind
Especifica el comportamiento deseado de enumeración de dispositivos de la función LampArrayStatusCallback. context   _In_opt_
Tipo: void*
Puntero a un objeto que contiene información relevante para la función de devolución de llamada. Normalmente, es el objeto que realiza la llamada. callbackToken   _Out_ _Result_zeroonfailure_ Tipo: LampArrayCallbackToken* Valor de token que se puede usar para anular el registro de la función de devolución de llamada más adelante.

Valor devuelto

Tipo: HRESULT Resultado de la función.

Comentarios

El parámetro LampArrayEnumerationKind permite que el autor de la llamada especifique cómo debe recibir devoluciones de llamada para los dispositivos LampArray que estén conectados en el momento de esta llamada. Si se selecciona LampArrayEnumerationKind::Blocking, la función RegisterLampArrayStatusCallback se bloqueará hasta que esa devolución de llamada se invoque para cada dispositivo conectado (lo que significa que la devolución de llamada se invocará en el subproceso que realiza la llamada). Cuando se registra la primera devolución de llamada, la API de LampArray inicia un subproceso de trabajo para gestionar las notificaciones de estado de dispositivos ILampArray. Estos eventos son poco frecuentes y, por lo demás, el subproceso de trabajo permanece en estado de espera. Después de que la llamada de registro se devuelva, todas las LampArrayStatusCallbacks posteriores se invocarán secuencialmente en este subproceso de trabajo. Si se especifica LampArrayEnumerationKind::Async, esta llamada se devolverá inmediatamente, y los LampArray conectados en el momento de la llamada se enumerarán en el subproceso de trabajo de devoluciones de llamada de LampArray mencionado anteriormente. El código siguiente es un ejemplo de registro y anulación del registro de una función LampArrayStatusCallback:

Requisitos

Encabezado: LampArray.h Biblioteca: xgameplatform.lib Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Información general de la API de iluminación
Conceptos básicos de iluminación
LampArrayStatusCallback
UnregisterLampArrayCallback
LampArrayEnumerationKind
Última modificación el 28 de agosto de 2026