DeviceServicingTrigger Classe

  • Référence

Définition

Espace de noms:
Windows.ApplicationModel.Background
Modifier

Représente un événement qu’une application peut déclencher pour lancer une mise à jour longue (microprogramme ou paramètres) d’un appareil.

Windows 8.1 vous permet de développer une application UWP pour vos périphériques qui communiquent via USB, HID et Bluetooth. Par exemple, un utilisateur peut avoir besoin de synchroniser le contenu d’un PC vers ou à partir de l’appareil, ou d’effectuer une mise à jour de longue durée de l’appareil lui-même, comme les mises à jour des paramètres ou du microprogramme. Windows 8.1 fournit deux tâches en arrière-plan et les API correspondantes qui permettent à votre appareil de synchroniser et de mettre à jour en arrière-plan : DeviceServicingTrigger et DeviceUseTrigger. Cette rubrique fournit des informations de référence sur les API pour DeviceServicingTrigger. Pour plus d’informations sur l’utilisation de ce déclencheur dans le contexte d’une application d’appareil, consultez Synchronisation et mise à jour des appareils pour les applications d’appareil UWP.

La tâche en arrière-plan DeviceServicingTrigger permet à votre application UWP qui interagit avec votre appareil périphérique d’effectuer des mises à jour d’appareil de longue durée pendant la suspension de votre application, par exemple les transferts de paramètres ou les mises à jour du microprogramme. La mise à jour de votre appareil en arrière-plan nécessite l’approbation de l’utilisateur chaque fois que la tâche en arrière-plan est utilisée. Contrairement à la tâche en arrière-plan DeviceUseTrigger , la tâche en arrière-plan DeviceServicingTrigger permet le redémarrage et la déconnexion de l’appareil et autorise un maximum de 30 minutes d’activité en arrière-plan.

Important

Ce déclencheur ne peut pas être utilisé avec des tâches en arrière-plan à processus unique.

public ref class DeviceServicingTrigger sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DeviceServicingTrigger final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DeviceServicingTrigger final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DeviceServicingTrigger
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DeviceServicingTrigger
function DeviceServicingTrigger()
Public NotInheritable Class DeviceServicingTrigger
Héritage
Object Platform::Object IInspectable DeviceServicingTrigger
Attributs
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Implémente
IBackgroundTrigger

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Certaines stratégies sont appliquées par Windows pour garantir le consentement de l’utilisateur lors de la mise à jour de ses périphériques. Des stratégies supplémentaires sont appliquées pour préserver l’autonomie de la batterie de l’utilisateur lors de la synchronisation et de la mise à jour des appareils périphériques. La tâche en arrière-plan DeviceServicingTrigger est soumise aux stratégies suivantes :

  • La tâche en arrière-plan DeviceServicingTrigger nécessite le consentement de l’utilisateur chaque fois qu’elle est déclenchée.
  • Votre appareil doit être connecté ou jumelé au PC et disponible lors de la demande de DeviceServicingTrigger.
  • Votre application est autorisée à un maximum de 30 minutes (horloge murale) d’activité en arrière-plan pour les mises à jour des appareils avec DeviceServicingTrigger
  • Votre application n’est pas autorisée à demander une tâche en arrière-plan DeviceServicingTrigger tant que votre application n’est pas au premier plan.
  • Votre application ne peut exécuter qu’un seul DeviceServicingTrigger à la fois. La tentative de création d’un second DeviceServicingTrigger génère une exception.
  • La batterie du PC doit avoir plus de 33 % de capacité restante, ou le PC doit être sous alimentation A/C.
  • Les tâches en arrière-plan DeviceServicingTrigger peuvent être annulées par Windows lorsque ces exigences de stratégie ne sont plus remplies, y compris une quantité maximale de temps d’arrière-plan de l’horloge murale.

Notes

L’application UWP qui a l’intention d’utiliser la tâche en arrière-plan DeviceServicingTrigger doit également être une application privilégiée pour l’appareil. Le privilège d’application est spécifié dans les métadonnées d’appareil d’un appareil périphérique par le fabricant de l’appareil. Lorsqu’une application UWP tente de déclencher la tâche en arrière-plan DeviceServicingTrigger , Windows valide que l’application appelante est l’application privilégiée pour l’appareil qu’elle tente de mettre à jour. Si l’application n’est pas privilégiée pour l’appareil, Windows n’autorise pas le lancement de la tâche en arrière-plan.

Pour plus d’informations sur les privilèges d’application et les vérifications de stratégie appliquées par Windows pour la tâche en arrière-plan DeviceServicingTrigger , consultez Synchronisation et mise à jour des appareils pour les applications d’appareil UWP.

Constructeurs

DeviceServicingTrigger()

Constructeur pour DeviceServicingTrigger. Ne prend aucun paramètre.

Méthodes

RequestAsync(String, TimeSpan)

Déclenche la tâche en arrière-plan (paramètres ou mise à jour du microprogramme) et retourne un DeviceTriggerResult indiquant la réussite ou l’échec de la demande de déclencheur. Prend la chaîne DeviceInformation.ID et une estimation facultative de la durée d’exécution de la tâche en arrière-plan. Si votre application ne peut pas déterminer une estimation de temps appropriée, indiquez zéro comme temps estimé.
RequestAsync(String, TimeSpan, String)

Déclenche la tâche en arrière-plan (paramètres ou mise à jour du microprogramme) et retourne un DeviceTriggerResult indiquant la réussite ou l’échec de la demande de déclencheur. Prend la chaîne DeviceInformation.ID , une estimation facultative de la durée d’exécution de la tâche en arrière-plan et une chaîne facultative spécifique à l’application passée à la tâche en arrière-plan identifiant l’opération d’appareil à effectuer. Si votre application ne peut pas déterminer une estimation de temps appropriée, indiquez zéro comme temps estimé.

S’applique à

Voir aussi