Skip to main content

RegisterLampArrayCallback

Registra uma função de retorno de chamada a ser invocada sempre que um LampArray for conectado ou desconectado do sistema.

Sintaxe

Parâmetros

lampArrayCallback   _In_ Tipo: LampArrayCallback Uma função definida pelo chamador a ser registrada. Ela será invocada quando LampArrays forem conectados ou desconectados do sistema. context   _In_opt_
Tipo: void*
Um ponteiro para um objeto que contém informações relevantes para a função de retorno de chamada. Normalmente, é o objeto que faz a chamada. callbackToken   _Out_ _Result_zeroonfailure_ Tipo: LampArrayCallbackToken* Um valor de token que pode ser usado para cancelar o registro da função de retorno de chamada posteriormente.

Valor retornado

Tipo: HRESULT Resultado da função.

Comentários

Se houver dispositivos LampArray conectados no momento em que um retorno de chamada for registrado, a função RegisterLampArrayCallback bloqueará até que esse retorno de chamada seja invocado para cada dispositivo conectado (o que significa que o retorno de chamada será invocado no thread de chamada). Quando o primeiro retorno de chamada é registrado, a API LampArray inicia um thread de trabalho para lidar com as notificações de conexão e remoção de dispositivos ILampArray. Esses eventos são pouco frequentes e, fora isso, o thread de trabalho permanece em estado de espera. Depois que a chamada de registro retorna, todos os LampArrayCallbacks subsequentes serão invocados sequencialmente nesse thread de trabalho. O código a seguir é um exemplo de registro e cancelamento de registro de um retorno de chamada de LampArray:

Requisitos

Cabeçalho: LampArray.h Biblioteca: xgameplatform.lib Plataformas compatíveis: consoles da família XBOX One e consoles XBOX Series

Confira também

Visão geral da API de iluminação
Noções básicas de iluminação
LampArrayCallback
UnregisterLampArrayCallback
Last modified on October 6, 2026