Skip to main content

Referência da API de iluminação

Material de referência da API de iluminação para o Microsoft Game Development Kit (GDK). Use essas APIs para enumerar periféricos LampArray compatíveis (teclados, mouses, headsets e outros dispositivos de iluminação HID) e controlar sua iluminação RGB.

Enumerar periféricos compatíveis

Para descobrir periféricos compatíveis, registre um retorno de chamada de status que a API LampArray invoca para cada dispositivo conectado e novamente sempre que um dispositivo é conectado ou removido.
  1. Implemente uma função LampArrayStatusCallback para receber eventos de conexão e desconexão de dispositivos.
  2. Chame RegisterLampArrayStatusCallback para registrar o retorno de chamada. Passe um valor de LampArrayEnumerationKind para controlar se a enumeração inicial é executada de forma assíncrona ou fica bloqueada até que todos os dispositivos conectados tenham sido relatados.
  3. No retorno de chamada, inspecione a instância de ILampArray para ler propriedades do dispositivo, como DeviceId, LampArrayKind, LampCount, VendorId e ProductId.
  4. Quando não precisar mais de notificações, chame UnregisterLampArrayCallback para parar de receber eventos.
Para obter um passo a passo completo com código de exemplo, consulte Noções básicas do LampArray.

Nesta seção

LampArray
Membros da API LampArray, incluindo as funções, interfaces, enumerações e structs usadas para enumerar dispositivos e controlar a iluminação.

Confira também

Visão geral da API de iluminação
Last modified on October 6, 2026