Compartilhar via


LampArray Classe

Definição

Representa um dispositivo LampArray anexado ao sistema. Atualmente, há suporte apenas para LAMPArrays HID .

public ref class LampArray sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LampArray final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LampArray
Public NotInheritable Class LampArray
Herança
Object Platform::Object IInspectable LampArray
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10, version 1809 (introduzida na 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v7.0)

Exemplos

Exemplo de LampArray

Demonstra como controlar a iluminação RGB de dispositivos periféricos usando as APIs Windows.Devices.Lights e Windows.Devices.Lights.Effects .

Exemplo do AutoRGB

Demonstra como extrair uma única cor representativa de uma tela de desktop e usá-la para iluminar lâmpadas LED em um dispositivo RGB conectado.

Comentários

Os dispositivos LampArray têm um ou mais índices de lâmpada (por exemplo, luzes/LEDs/lâmpadas etc.) cujo estado de cor pode ser manipulado diretamente. As informações estáticas (recuperadas do dispositivo) descrevem cores com suporte, posições geométricas e finalidades pretendidas para cada índice de lâmpada.

Esses dispositivos podem ser encontrados como parte de dispositivos compostos (por exemplo, teclado com iluminação RGB) ou como autônomos.

Um aplicativo pode definir o estado da lâmpada a qualquer momento, mas o estado só será aplicado pelo sistema enquanto o aplicativo estiver em foco.

LampArrays são enumerados por DeviceWatcher e recuperados por meio de FromIdAsync.

Propriedades

BoundingBox

Obtém a caixa delimitadora lógica que abrange o LampArray.

BrightnessLevel

Obtém ou define o brilho geral do LampArray, em que 0,0 está completamente desativado e 1,0 é o brilho máximo.

Cada lâmpada é dimensionada igualmente pelo brilho.

DeviceId

Obtém o identificador de dispositivo PnP (plug and play) do dispositivo LampArray subjacente.

HardwareProductId

A ID do produto de hardware do dispositivo subjacente.

HardwareVendorId

A ID do fornecedor de hardware do dispositivo subjacente.

HardwareVersion

A versão de hardware do dispositivo subjacente.

IsAvailable

Obtém se a matriz de lâmpadas está disponível ou indisponível para controle por esse processo.

IsConnected

Obtém um valor que indica se o dispositivo LampArray está conectado ao sistema.

IsEnabled

Obtém ou define o estado habilitado.

LampArrayKind

Obtém o tipo de dispositivo de matriz de lâmpadas.

LampCount

O número de lâmpadas parte deste LampArray.

MinUpdateInterval

Intervalo mínimo (exigido pelo dispositivo) entre o sistema que envia duas atualizações para qualquer lâmpada. Isso é comparável à taxa de atualização efetiva do dispositivo.

SupportsVirtualKeys

Booliano que indica se alguma lâmpada é mapeada para uma chave virtual.

Métodos

FromIdAsync(String)

Recupera um objeto LampArray de forma assíncrona para o dispositivo LampArray que tem o caminho de instância do dispositivo PnP (plug and play) especificado.

GetDeviceSelector()

Recupera uma cadeia de caracteres AQS (Sintaxe de Consulta Avançada) que abrange todos os dispositivos LampArray no sistema.

GetIndicesForKey(VirtualKey)

Pesquisa todos os índices de lâmpada associados à VirtualKey específica

GetIndicesForPurposes(LampPurposes)

Pesquisa todos os índices de lâmpadas associados aos LampPurposes especificados.

GetLampInfo(Int32)

Busca o LampInfo correspondente ao índice da lâmpada.

RequestMessageAsync(Int32)

Recupera de forma assíncrona um IBuffer que representa a mensagem identificada pelo argumento identifer da mensagem.

SendMessageAsync(Int32, IBuffer)

Envia de forma assíncrona uma mensagem identificada pelo argumento identifer da mensagem.

SetColor(Color)

Define cada lâmpada que pertence ao LampArray como a cor desejada.

SetColorForIndex(Int32, Color)

Define a lâmpada correspondente ao índice como a cor desejada.

SetColorsForIndices(Color[], Int32[])

Define a cor de várias lâmpadas. A posição dentro de cada matriz mapeia o índice da lâmpada para a cor desejada.

SetColorsForKey(Color, VirtualKey)

Define a cor de todas as lâmpadas mapeadas para a chave. Várias lâmpadas podem ser mapeadas para a mesma chave.

SetColorsForKeys(Color[], VirtualKey[])

Define a cor de várias lâmpadas, correspondentes às teclas mapeadas. A posição dentro de cada matriz mapeia as chaves para a cor desejada.

SetColorsForPurposes(Color, LampPurposes)

Define a cor de várias lâmpadas, correspondentes a LampPurposes.

SetSingleColorForIndices(Color, Int32[])

Define todas as lâmpadas especificadas com a mesma cor.

Eventos

AvailabilityChanged

É gerado quando o valor de IsAvailable é alterado; o que pode acontecer quando o usuário altera o acesso do sistema ao dispositivo por meio das configurações do dispositivo.

Os parâmetros do manipulador de eventos são o remetente LampArray cuja propriedade foi alterada e um Object (que é sempre nulo).

Aplica-se a

Confira também