LampArray Classe

Definição

Namespace:

Windows.Devices.Lights

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

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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).

Confira também

• Iluminação e Iluminação (www.usb.org)
• Iluminação dinâmica