LampArray Clase

Definición

Espacio de nombres:

Windows.Devices.Lights

Representa un dispositivo LampArray conectado al sistema. Actualmente, solo se admiten 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

Herencia

Object Platform::Object IInspectable LampArray

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v7.0)

Ejemplos

Ejemplo lampArray

Muestra cómo controlar la iluminación RGB de los dispositivos periféricos mediante las API Windows.Devices.Lights y Windows.Devices.Lights.Effects .

Ejemplo de AutoRGB

Muestra cómo extraer un único color representativo de una pantalla de escritorio y usarlo para iluminar lámparas LED en un dispositivo RGB conectado.

Comentarios

Los dispositivos LampArray tienen uno o más índices de lámpara (por ejemplo, luces/LED/bombillas, etc.) cuyo estado de color se puede manipular directamente. La información estática (recuperada del dispositivo) describe los colores admitidos, las posiciones geométricas y los propósitos previstos para cada índice de lámpara.

Estos dispositivos se pueden encontrar como parte de dispositivos compuestos (por ejemplo, teclado con iluminación RGB) o como independiente.

Una aplicación puede establecer el estado de la lámpara en cualquier momento, pero el sistema solo aplicará el estado mientras la aplicación está en el foco.

LampArrays se enumeran mediante DeviceWatcher y se recuperan a través de FromIdAsync.

Propiedades

BoundingBox	Obtiene el rectángulo delimitador lógico que abarca LampArray.
BrightnessLevel	Obtiene o establece el brillo general de LampArray, donde 0,0 está completamente desactivado y 1,0 es el brillo máximo. Cada lámpara se escala igualmente por el brillo.
DeviceId	Obtiene el identificador de dispositivo plug and play (PnP) del dispositivo LampArray subyacente.
HardwareProductId	Identificador de producto de hardware del dispositivo subyacente.
HardwareVendorId	Identificador del proveedor de hardware del dispositivo subyacente.
HardwareVersion	Versión de hardware del dispositivo subyacente.
IsAvailable	Obtiene si la matriz de lámpara está disponible o no está disponible para el control por este proceso.
IsConnected	Obtiene un valor que indica si el dispositivo LampArray está conectado al sistema.
IsEnabled	Obtiene o establece el estado habilitado.
LampArrayKind	Obtiene el tipo de dispositivo de matriz de lámpara.
LampCount	El número de lámparas que forman parte de este LampArray.
MinUpdateInterval	Intervalo mínimo (requerido por el dispositivo) entre el sistema que envía dos actualizaciones para cualquier lámpara. Esto es comparable a la frecuencia de actualización efectiva del dispositivo.
SupportsVirtualKeys	Boolean que indica si alguna lámpara está asignada a una clave virtual.

Métodos

FromIdAsync(String)	Recupera un objeto LampArray de forma asincrónica para el dispositivo LampArray que tiene la ruta de acceso especificada del dispositivo plug and play (PnP).
GetDeviceSelector()	Recupera una cadena de sintaxis de consulta avanzada (AQS) que abarca todos los dispositivos LampArray del sistema.
GetIndicesForKey(VirtualKey)	Busca todos los índices de lámpara enlazados a la clave virtual específica.
GetIndicesForPurposes(LampPurposes)	Busca todos los índices de lámpara enlazados a lampPurposes especificados.
GetLampInfo(Int32)	Captura lampInfo correspondiente al índice de la lámpara.
RequestMessageAsync(Int32)	Recupera de forma asincrónica un IBuffer que representa el mensaje identificado por el argumento de identificador del mensaje.
SendMessageAsync(Int32, IBuffer)	Envía de forma asincrónica un mensaje identificado por el argumento identifer del mensaje.
SetColor(Color)	Establece todas las lámparas que pertenecen a LampArray en el color deseado.
SetColorForIndex(Int32, Color)	Establece la lámpara correspondiente al índice en el color deseado.
SetColorsForIndices(Color[], Int32[])	Establece el color de varias lámparas. La posición dentro de cada matriz asigna el índice de la lámpara al color deseado.
SetColorsForKey(Color, VirtualKey)	Establece el color de todas las lámparas que se asignan a la clave. Varias lámparas pueden asignarse a la misma clave.
SetColorsForKeys(Color[], VirtualKey[])	Establece el color de varias lámparas, correspondientes a las teclas asignadas. La posición dentro de cada matriz asigna las claves al color deseado.
SetColorsForPurposes(Color, LampPurposes)	Establece el color de varias lámparas, correspondientes a LampPurposes.
SetSingleColorForIndices(Color, Int32[])	Establece todas las lámparas especificadas en el mismo color.

Eventos

AvailabilityChanged

Se genera cuando cambia el valor de IsAvailable ; lo que puede ocurrir cuando el usuario cambia el acceso del sistema al dispositivo a través de la configuración del dispositivo. Los parámetros del controlador de eventos son el remitente LampArray cuya propiedad ha cambiado y un objeto (que siempre es null).

Consulte también

• Iluminación e iluminación (www.usb.org)
• Iluminación dinámica