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. enumerationKindTipo: 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 SeriesConfira também
Visão geral da API de iluminaçãoNoções básicas de iluminação
LampArrayStatusCallback
UnregisterLampArrayCallback
LampArrayEnumerationKind
