Skip to main content

RegisterLampArrayCallback

Registra una función de devolución de llamada que se invocará cada vez que un LampArray se conecte o desconecte del sistema.

Sintaxis

Parámetros

lampArrayCallback   _In_ Tipo: LampArrayCallback Función definida por el autor de la llamada que se va a registrar. Se invocará cuando se conecten o desconecten LampArrays del sistema. 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

Si hay dispositivos LampArray conectados en el momento en que se registra una devolución de llamada, la función RegisterLampArrayCallback 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 conexión y eliminación 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 LampArrayCallbacks posteriores se invocarán secuencialmente en este subproceso de trabajo. El código siguiente es un ejemplo de registro y anulación del registro de una devolución de llamada de LampArray:

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
LampArrayCallback
UnregisterLampArrayCallback
Última modificación el 28 de agosto de 2026