LampArray 클래스

정의

네임스페이스:

Windows.Devices.Lights

시스템에 연결된 LampArray 디바이스를 나타냅니다. 현재 HID LampArrays 만 지원됩니다.

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

상속

Object Platform::Object IInspectable LampArray

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10, version 1809 (10.0.17763.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v7.0에서 도입되었습니다.)

예제

LampArray 샘플

Windows.Devices.Lights 및 Windows.Devices.Lights.Effects API를 사용하여 주변 장치의 RGB 조명을 제어하는 방법을 보여 줍니다.

AutoRGB 샘플

데스크톱 화면에서 대표적인 단일 색을 추출하고 이를 사용하여 연결된 RGB 디바이스에서 LED 램프를 비추는 방법을 보여 줍니다.

설명

LampArray 디바이스에는 색 상태를 직접 조작할 수 있는 하나 이상의 램프 인덱스(예: 조명/LED/전구 등)가 있습니다. 정적 정보(디바이스에서 검색됨)는 각 램프 인덱스에 대해 지원되는 색, 기하학적 위치 및 의도된 용도를 설명합니다.

이러한 디바이스는 복합 디바이스(예: RGB 조명이 있는 키보드)의 일부 또는 독립 실행형으로 찾을 수 있습니다.

애플리케이션은 언제든지 램프 상태를 설정할 수 있지만 애플리케이션이 포커스가 있는 동안에는 시스템에서만 상태가 적용됩니다.

LampArrays는 DeviceWatcher에 의해 열거되고 FromIdAsync를 통해 검색됩니다.

속성

BoundingBox	LampArray를 포함하는 논리적 경계 상자를 가져옵니다.
BrightnessLevel	0.0이 완전히 꺼지고 1.0이 최대 밝기인 LampArray의 전체 밝기를 가져오거나 설정합니다. 모든 램프는 밝기별로 동일하게 조정됩니다.
DeviceId	기본 LampArray 디바이스의 플러그 앤 플레이(PnP) 디바이스 식별자를 가져옵니다.
HardwareProductId	기본 디바이스의 하드웨어 제품 ID입니다.
HardwareVendorId	기본 디바이스의 하드웨어 공급업체 ID입니다.
HardwareVersion	기본 디바이스의 하드웨어 버전입니다.
IsAvailable	이 프로세스에서 램프 배열을 제어할 수 있는지 여부를 가져옵니다.
IsConnected	LampArray 디바이스가 시스템에 연결되어 있는지 여부를 나타내는 값을 가져옵니다.
IsEnabled	사용 상태를 가져오거나 설정합니다.
LampArrayKind	램프 배열 디바이스의 유형을 가져옵니다.
LampCount	이 LampArray의 램프 부분 수입니다.
MinUpdateInterval	하나의 램프에 대해 두 개의 업데이트를 보내는 시스템 간의 최소 간격(디바이스에 필요)입니다. 이는 효과적인 디바이스 새로 고침 속도와 비슷합니다.
SupportsVirtualKeys	램프가 가상 키에 매핑되는지 여부를 나타내는 부울입니다.

메서드

FromIdAsync(String)	지정된 PnP(플러그 앤 플레이) 디바이스 식별자/디바이스 instance 경로가 있는 LampArray 디바이스에 대해 LampArray 개체를 비동기적으로 검색합니다.
GetDeviceSelector()	시스템의 모든 LampArray 디바이스를 포함하는 AQS(고급 쿼리 구문) 문자열을 검색합니다.
GetIndicesForKey(VirtualKey)	특정 VirtualKey에 바인딩된 모든 램프 인덱스를 검색합니다.
GetIndicesForPurposes(LampPurposes)	지정된 LampPurposes에 바인딩된 모든 램프 인덱스를 검색합니다.
GetLampInfo(Int32)	램프 인덱스에 해당하는 LampInfo 를 가져옵니다.
RequestMessageAsync(Int32)	메시지 identifer 인수로 식별된 메시지를 나타내는 IBuffer 를 비동기적으로 검색합니다.
SendMessageAsync(Int32, IBuffer)	메시지 identifer 인수로 식별된 메시지를 비동기적으로 보냅니다.
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)
• 동적 조명