LampArray Класс

Определение

Пространство имен:

Windows.Devices.Lights

Представляет устройство LampArray, подключенное к системе. В настоящее время поддерживаются только HID LampArrays .

[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

Наследование

Object LampArray

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10, version 1809 (появилось в 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v7.0)

Примеры

Пример LampArray

Демонстрирует, как управлять rgb-освещением периферийных устройств с помощью API Windows.Devices.Lights и Windows.Devices.Lights.Effects .

Пример AutoRGB

Демонстрирует, как извлечь один репрезентативный цвет с экрана рабочего стола и использовать его для освещения светодиодных ламп на подключенном устройстве RGB.

Комментарии

Устройства LampArray имеют один или несколько индексов ламп (например, индикаторы, лампочки и т. д.), цветом которых можно управлять напрямую. Статические сведения (полученные с устройства) описывают поддерживаемые цвета, геометрические положения и предполагаемые цели для каждого индекса лампы.

Эти устройства можно найти как часть составных устройств (например, клавиатура с rgb-освещением) или как автономные.

Приложение может задать состояние лампы в любое время, но состояние будет применяться системой только в то время, когда приложение находится в фокусе.

LampArrays перечисляются с помощью DeviceWatcher и извлекаются с помощью FromIdAsync.

Свойства

BoundingBox	Возвращает логический ограничивающий прямоугольник, охватывающий Объект LampArray.
BrightnessLevel	Возвращает или задает общую яркость LampArray, где 0,0 полностью выключено, а 1,0 — максимальная яркость. Каждая лампа масштабируется одинаково по яркости.
DeviceId	Возвращает идентификатор устройства Plug and Play (PnP) базового устройства LampArray.
HardwareProductId	Идентификатор аппаратного продукта базового устройства.
HardwareVendorId	Идентификатор поставщика оборудования базового устройства.
HardwareVersion	Версия оборудования базового устройства.
IsAvailable	Возвращает значение, указывающее, является ли массив лампы доступным или недоступным для управления этим процессом.
IsConnected	Возвращает значение, указывающее, подключено ли устройство LampArray к системе.
IsEnabled	Возвращает или задает состояние enabled.
LampArrayKind	Возвращает тип устройства массива ламп.
LampCount	Количество ламп частью этого LampArray.
MinUpdateInterval	Минимальный интервал (требуется устройством) между системой, отправляя два обновления для любой лампы. Это сравнимо с эффективной частотой обновления устройства.
SupportsVirtualKeys	Логическое значение, указывающее, сопоставляется ли лампа с виртуальным ключом.

Методы

FromIdAsync(String)	Асинхронно извлекает объект LampArray для устройства LampArray, которое имеет указанный идентификатор устройства plug and play (PnP) или путь к экземпляру устройства.
GetDeviceSelector()	Извлекает строку расширенного синтаксиса запросов (AQS), охватывающую все устройства LampArray в системе.
GetIndicesForKey(VirtualKey)	Выполняет поиск всех индексов лампы, привязанных к определенному ключу VirtualKey
GetIndicesForPurposes(LampPurposes)	Выполняет поиск всех индексов лампы, привязанных к указанному объекту LampPurposes.
GetLampInfo(Int32)	Извлекает объект LampInfo , соответствующий индексу лампы.
RequestMessageAsync(Int32)	Асинхронно извлекает IBuffer , представляющий сообщение, определенное аргументом идентификатора сообщения.
SendMessageAsync(Int32, IBuffer)	Асинхронно отправляет сообщение, определенное аргументом идентификатора сообщения.
SetColor(Color)	Устанавливает для каждой лампы, принадлежащей LampArray, нужный цвет.
SetColorForIndex(Int32, Color)	Задает для лампы, соответствующей индексу, нужный цвет.
SetColorsForIndices(Color[], Int32[])	Задает цвет для нескольких ламп. Положение в каждом массиве сопоставляет индекс лампы с нужным цветом.
SetColorsForKey(Color, VirtualKey)	Задает цвет для всех ламп, сопоставленных с ключом. Несколько ламп могут сопоставляться с одним и тем же ключом.
SetColorsForKeys(Color[], VirtualKey[])	Задает цвет нескольких ламп, соответствующих сопоставленным клавишам. Расположение в каждом массиве сопоставляет ключи с нужным цветом.
SetColorsForPurposes(Color, LampPurposes)	Задает цвет нескольких ламп, соответствующих LampPurposes.
SetSingleColorForIndices(Color, Int32[])	Задает для всех указанных ламп одинаковый цвет.

События

AvailabilityChanged

Возникает при изменении значения IsAvailable ; это может произойти, когда пользователь изменяет системный доступ к устройству с помощью параметров устройства. Параметры обработчика событий — это отправитель LampArray , свойство которого изменилось, и объект Object (который всегда имеет значение NULL).

Применяется к

См. также раздел

• Освещение и освещение (www.usb.org)
• Динамическое освещение