LampArray Classe

Définition

Espace de noms:

Windows.Devices.Lights

Représente un appareil LampArray attaché au système. Actuellement, seuls hid LampArrays sont pris en charge.

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

Héritage

Object Platform::Object IInspectable LampArray

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1809 (introduit dans 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v7.0)

Exemples

Exemple LampArray

Montre comment contrôler l’éclairage RVB des périphériques à l’aide des API Windows.Devices.Lights et Windows.Devices.Lights.Effects .

Exemple AutoRGB

Montre comment extraire une couleur unique et représentative d’un écran de bureau et l’utiliser pour éclairer des lampes DEL sur un appareil RVB connecté.

Remarques

Les appareils LampArray ont un ou plusieurs index de lampe (par exemple, lumières/LED/ampoules, etc...) dont l’état de couleur peut être directement manipulé. Les informations statiques (récupérées à partir de l’appareil) décrivent les couleurs prises en charge, les positions géométriques et les objectifs prévus pour chaque index de lampe.

Ces appareils peuvent être trouvés dans le cadre d’appareils composites (par exemple, clavier avec éclairage RVB) ou en tant qu’appareils autonomes.

Une application peut définir l’état de la lampe à tout moment, mais l’état n’est appliqué que par le système lorsque l’application est en focus.

Les LampArrays sont énumérés par DeviceWatcher et récupérés via FromIdAsync.

Propriétés

BoundingBox	Obtient le cadre englobant le LampArray.
BrightnessLevel	Obtient ou définit la luminosité globale du LampArray, où 0,0 est complètement désactivé et 1,0 est la luminosité maximale. Chaque lampe est également mise à l’échelle par la luminosité.
DeviceId	Obtient l’identificateur d’appareil plug-and-play (PnP) de l’appareil LampArray sous-jacent.
HardwareProductId	ID de produit matériel de l’appareil sous-jacent.
HardwareVendorId	ID du fournisseur de matériel de l’appareil sous-jacent.
HardwareVersion	Version matérielle de l’appareil sous-jacent.
IsAvailable	Obtient si le tableau de lampes est disponible ou indisponible pour le contrôle par ce processus.
IsConnected	Obtient une valeur indiquant si l’appareil LampArray est connecté au système.
IsEnabled	Obtient ou définit l’état activé.
LampArrayKind	Obtient le type d’appareil de tableau de lampe.
LampCount	Nombre de lampes qui font partie de cette LampArray.
MinUpdateInterval	Intervalle minimal (requis par l’appareil) entre le système qui envoie deux mises à jour pour une seule lampe. Cela est comparable au taux d’actualisation effectif de l’appareil.
SupportsVirtualKeys	Boolean indiquant si une lampe est mappée à une clé virtuelle.

Méthodes

FromIdAsync(String)	Récupère un objet LampArray de manière asynchrone pour l’appareil LampArray qui a le chemin d’instance accès d’appareil plug-and-play (PnP) spécifié.
GetDeviceSelector()	Récupère une chaîne AQS (Advanced Query Syntax) englobant tous les appareils LampArray sur le système.
GetIndicesForKey(VirtualKey)	Recherche tous les index de lampe liés à la clé virtuelle spécifique
GetIndicesForPurposes(LampPurposes)	Recherche tous les index de lampe liés aux LampPurposes spécifiés.
GetLampInfo(Int32)	Extrait le LampInfo correspondant à l’index de la lampe.
RequestMessageAsync(Int32)	Récupère de manière asynchrone un IBuffer représentant le message identifié par l’argument identifer du message.
SendMessageAsync(Int32, IBuffer)	Envoie de manière asynchrone un message identifié par l’argument identifer de message.
SetColor(Color)	Définit chaque lampe appartenant au LampArray à la couleur souhaitée.
SetColorForIndex(Int32, Color)	Définit la lampe correspondant à l’index sur la couleur souhaitée.
SetColorsForIndices(Color[], Int32[])	Définit la couleur de plusieurs lampes. La position dans chaque tableau mappe l’index de la lampe à la couleur souhaitée.
SetColorsForKey(Color, VirtualKey)	Définit la couleur de toutes les lampes mappées à la clé. Plusieurs lampes peuvent être mappées à la même clé.
SetColorsForKeys(Color[], VirtualKey[])	Définit la couleur de plusieurs lampes, correspondant aux clés mappées. La position dans chaque tableau mappe les clés à la couleur souhaitée.
SetColorsForPurposes(Color, LampPurposes)	Définit la couleur de plusieurs lampes, correspondant à LampPurposes.
SetSingleColorForIndices(Color, Int32[])	Définit toutes les lampes spécifiées sur la même couleur.

Événements

AvailabilityChanged

Est déclenché lorsque la valeur de IsAvailable change ; ce qui peut se produire lorsque l’utilisateur modifie l’accès système à l’appareil via les paramètres de l’appareil. Les paramètres du gestionnaire d’événements sont l’expéditeur LampArray dont la propriété a été modifiée et un objet (toujours null).

Voir aussi

• Éclairage et éclairage (www.usb.org)
• Éclairage dynamique