Partager via

énumération BG_JOB_PRIORITY (bits.h)

  • Article

Définit des constantes qui spécifient le niveau de priorité d’un travail.

Syntax

typedef enum BG_JOB_PRIORITY {
  BG_JOB_PRIORITY_FOREGROUND = 0,
  BG_JOB_PRIORITY_HIGH,
  BG_JOB_PRIORITY_NORMAL,
  BG_JOB_PRIORITY_LOW
} ;

Constantes

 
BG_JOB_PRIORITY_FOREGROUND
Valeur : 0
Transfère le travail au premier plan. Les transferts de premier plan sont en concurrence pour la bande passante réseau avec d’autres applications, ce qui peut nuire à l’expérience réseau de l’utilisateur. Il s’agit du niveau de priorité le plus élevé.
BG_JOB_PRIORITY_HIGH
Transfère le travail en arrière-plan avec une priorité élevée. Les transferts en arrière-plan utilisent la bande passante réseau inactive du client pour transférer des fichiers. Il s’agit du niveau de priorité d’arrière-plan le plus élevé.
BG_JOB_PRIORITY_NORMAL
Transfère le travail en arrière-plan avec une priorité normale. Les transferts en arrière-plan utilisent la bande passante réseau inactive du client pour transférer des fichiers. Il s’agit du niveau de priorité par défaut.
BG_JOB_PRIORITY_LOW
Transfère le travail en arrière-plan avec une priorité basse. Les transferts en arrière-plan utilisent la bande passante réseau inactive du client pour transférer des fichiers. C’est le niveau de priorité d’arrière-plan le plus bas.

Remarques

Pour un travail en arrière-plan, le niveau de priorité détermine quand le travail est traité par rapport à d’autres travaux dans la file d’attente de transfert. Un travail de priorité plus élevée préempte un travail de priorité inférieure. Les travaux au même niveau de priorité partagent le temps de transfert, ce qui empêche un travail volumineux de bloquer la file d’attente de transfert. Les travaux de priorité inférieure ne reçoivent pas de temps de transfert tant que tous les travaux de priorité supérieure n’ont pas été transférés ou se trouvent dans un état d’erreur.

Plusieurs transferts de premier plan peuvent avoir lieu simultanément. Toutefois, plusieurs fichiers dans le même travail sont transférés séquentiellement. Par exemple, si vous souhaitez télécharger 5 fichiers simultanément, vous pouvez envisager de créer 5 travaux de premier plan, un pour chaque transfert.

BITS 1.5 et versions antérieures : BITS traite un travail à la fois. Les travaux de premier plan ont la priorité la plus élevée et s’exécutent avant les travaux en arrière-plan.

Pour plus d’informations, consultez Bonnes pratiques lors de l’utilisation de BITS.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP
Serveur minimal pris en charge Windows Server 2003
En-tête bits.h

Voir aussi