Skip to main content

RegisterLampArrayStatusCallback

Registra uma função de retorno de chamada a ser invocada sempre que o status do LampArray mudar.

Sintaxe

Parâmetros

callbackFunc   _In_ Tipo: LampArrayStatusCallback Uma função definida pelo chamador a ser registrada. Ela será invocada quando o status do LampArray mudar. enumerationKind
Tipo: LampArrayEnumerationKind
Especifica o comportamento desejado de enumeração de dispositivos da função LampArrayStatusCallback. 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

O parâmetro LampArrayEnumerationKind permite que o chamador especifique como deve receber retornos de chamada para quaisquer dispositivos LampArray conectados no momento desta chamada. Se LampArrayEnumerationKind::Blocking for selecionado, a função RegisterLampArrayStatusCallback 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 status 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 LampArrayStatusCallbacks subsequentes serão invocados sequencialmente nesse thread de trabalho. Se LampArrayEnumerationKind::Async for especificado, esta chamada retornará imediatamente, e quaisquer LampArrays conectados no momento da chamada serão enumerados no thread de trabalho de retorno de chamada do LampArray mencionado anteriormente. O código a seguir é um exemplo de registro e cancelamento de registro de uma função LampArrayStatusCallback:

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
LampArrayStatusCallback
UnregisterLampArrayCallback
LampArrayEnumerationKind
Last modified on October 6, 2026