LampArray Klasse

Definition

Namespace:

Windows.Devices.Lights

Stellt ein LampArray-Gerät dar, das an das System angefügt ist. Derzeit werden nur HID-LampArrays unterstützt.

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

Vererbung

Object Platform::Object IInspectable LampArray

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v7.0)

Beispiele

LampArray-Beispiel

Veranschaulicht, wie Die RGB-Beleuchtung von Peripheriegeräten mithilfe der Windows.Devices.Lights - und Windows.Devices.Lights.Effects-APIs gesteuert wird.

AutoRGB-Beispiel

Veranschaulicht, wie eine einzelne, repräsentative Farbe von einem Desktopbildschirm extrahiert und zur Aktivierung von LED-Lampen auf einem verbundenen RGB-Gerät verwendet wird.

Hinweise

LampArray-Geräte verfügen über einen oder mehrere Lampenindizes (z. B. Leuchten/LEDs/Glühbirnen usw.), deren Farbzustand direkt bearbeitet werden kann. Statische Informationen (vom Gerät abgerufen) beschreiben unterstützte Farben, geometrische Positionen und beabsichtigte Zwecke für jeden Lampenindex.

Diese Geräte können als Teil von zusammengesetzten Geräten (z. B. Tastatur mit RGB-Beleuchtung) oder als eigenständige Geräte gefunden werden.

Eine Anwendung kann den Lampenzustand jederzeit festlegen, aber der Zustand wird nur vom System angewendet, während die Anwendung den Fokus hat.

LampArrays werden von DeviceWatcher aufgelistet und über FromIdAsync abgerufen.

Eigenschaften

BoundingBox	Ruft das logische Begrenzungsfeld ab, das das LampArray umfasst.
BrightnessLevel	Ruft die Gesamthelligkeit des LampArray ab oder legt diese fest, wobei 0,0 vollständig deaktiviert und 1,0 die maximale Helligkeit ist. Jede Lampe wird durch die Helligkeit gleich skaliert.
DeviceId	Ruft den PnP-Gerätebezeichner (Plug and Play) des zugrunde liegenden LampArray-Geräts ab.
HardwareProductId	Die Hardwareprodukt-ID des zugrunde liegenden Geräts.
HardwareVendorId	Die Hardwareanbieter-ID des zugrunde liegenden Geräts.
HardwareVersion	Die Hardwareversion des zugrunde liegenden Geräts.
IsAvailable	Ruft ab, ob das Lampenarray für die Steuerung durch diesen Prozess verfügbar oder nicht verfügbar ist.
IsConnected	Ruft einen Wert ab, der angibt, ob das LampArray-Gerät mit dem System verbunden ist.
IsEnabled	Ruft den aktivierten Zustand ab oder legt diese fest.
LampArrayKind	Ruft den Typ des Lampenarraygeräts ab.
LampCount	Die Anzahl der Lampen, die teil dieses LampArray sind.
MinUpdateInterval	Minimales Intervall (vom Gerät erforderlich) zwischen dem System, das zwei Updates für eine beliebige Lampe sendet. Dies ist vergleichbar mit der effektiven Aktualisierungsrate des Geräts.
SupportsVirtualKeys	Boolesch, der angibt, ob eine Lampe einem virtuellen Schlüssel zugeordnet ist.

Methoden

FromIdAsync(String)	Ruft ein LampArray-Objekt asynchron für das LampArray-Gerät ab, das über den angegebenen PnP-Gerätebezeichner/Geräte-instance-Pfad verfügt.
GetDeviceSelector()	Ruft eine AQS-Zeichenfolge (Advanced Query Syntax) ab, die alle LampArray-Geräte im System umfasst.
GetIndicesForKey(VirtualKey)	Sucht nach allen Lampenindizes, die an den spezifischen VirtualKey gebunden sind
GetIndicesForPurposes(LampPurposes)	Sucht nach allen Lampenindizes, die an die angegebenen LampPurposes gebunden sind.
GetLampInfo(Int32)	Ruft die LampInfo ab, die dem Lampenindex entspricht.
RequestMessageAsync(Int32)	Ruft asynchron einen IBuffer ab, der die durch das Argument Nachrichtenidentifer identifizierte Nachricht darstellt.
SendMessageAsync(Int32, IBuffer)	Sendet asynchron eine Nachricht, die durch das Argument "Nachrichtenidentifer" identifiziert wird.
SetColor(Color)	Legt jede Lampe, die zum LampArray gehört, auf die gewünschte Farbe fest.
SetColorForIndex(Int32, Color)	Legt die dem Index entsprechende Lampe auf die gewünschte Farbe fest.
SetColorsForIndices(Color[], Int32[])	Legt die Farbe für mehrere Lampen fest. Die Position innerhalb jedes Arrays ordnet den Lampenindex der gewünschten Farbe zu.
SetColorsForKey(Color, VirtualKey)	Legt die Farbe für alle Lampen fest, die dem Schlüssel zugeordnet sind. Mehrere Lampen können demselben Schlüssel zugeordnet werden.
SetColorsForKeys(Color[], VirtualKey[])	Legt die Farbe mehrerer Lampen fest, die zugeordneten Tasten entsprechen. Position innerhalb jedes Arrays ordnet Schlüssel der gewünschten Farbe zu.
SetColorsForPurposes(Color, LampPurposes)	Legt die Farbe mehrerer Lampen entsprechend LampPurposes fest.
SetSingleColorForIndices(Color, Int32[])	Legt alle angegebenen Lampen auf dieselbe Farbe fest.

Ereignisse

AvailabilityChanged

Wird ausgelöst, wenn sich der Wert von IsAvailable ändert. Dies kann passieren, wenn der Benutzer den Systemzugriff auf das Gerät über die Geräteeinstellungen ändert. Die Parameter des Ereignishandlers sind der Absender LampArray , dessen Eigenschaft geändert wurde, und ein Object (immer NULL).

Weitere Informationen

• Beleuchtung und Beleuchtung (www.usb.org)
• Dynamische Beleuchtung