ホーム › Networking.BackgroundIntelligentTransferService › BG_JOB_PRIORITY

BG_JOB_PRIORITY

列挙型

基底型i4

メンバー 4

名前	10進	16進	説明
BG_JOB_PRIORITY_FOREGROUND	0	0x0	ジョブをフォアグラウンドで転送します。フォアグラウンド転送は他のアプリケーションとネットワーク帯域幅を奪い合うため、ユーザーのネットワーク操作を妨げる可能性があります。これは最も高い優先度レベルです。
BG_JOB_PRIORITY_HIGH	1	0x1	ジョブをバックグラウンドで高い優先度で転送します。バックグラウンド転送では、クライアントの空いているネットワーク帯域幅を使用してファイルを転送します。これはバックグラウンドで最も高い優先度レベルです。
BG_JOB_PRIORITY_NORMAL	2	0x2	ジョブをバックグラウンドで通常の優先度で転送します。バックグラウンド転送では、クライアントの空いているネットワーク帯域幅を使用してファイルを転送します。これは既定の優先度レベルです。
BG_JOB_PRIORITY_LOW	3	0x3	ジョブをバックグラウンドで低い優先度で転送します。バックグラウンド転送では、クライアントの空いているネットワーク帯域幅を使用してファイルを転送します。これはバックグラウンドで最も低い優先度レベルです。

公式ドキュメント

ジョブの優先度レベルを指定する定数を定義します。

解説(Remarks)

バックグラウンドジョブの場合、優先度レベルによって、転送キュー内の他のジョブに対していつそのジョブが処理されるかが決まります。優先度の高いジョブは、優先度の低いジョブに優先して処理されます。同じ優先度レベルのジョブは転送時間を分け合うため、大きなジョブが転送キューをブロックすることを防ぎます。優先度の低いジョブは、優先度の高いジョブがすべて転送されるかエラー状態になるまで、転送時間を割り当てられません。

複数のフォアグラウンド転送を同時に実行できます。ただし、同じジョブ内の複数のファイルは順番に転送されます。たとえば、5 個のファイルを同時にダウンロードしたい場合は、転送ごとに 1 つずつ、5 個のフォアグラウンドジョブを作成することを検討してください。

BITS 1.5 以前: BITS は一度に 1 つのジョブを処理します。フォアグラウンドジョブは最も高い優先度を持ち、バックグラウンドジョブよりも先に実行されます。

詳細については、「BITS 使用時のベストプラクティス」を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum BG_JOB_PRIORITY : int {
    BG_JOB_PRIORITY_FOREGROUND = 0,
    BG_JOB_PRIORITY_HIGH = 1,
    BG_JOB_PRIORITY_NORMAL = 2,
    BG_JOB_PRIORITY_LOW = 3
} BG_JOB_PRIORITY;

public enum BG_JOB_PRIORITY : int
{
    BG_JOB_PRIORITY_FOREGROUND = 0,
    BG_JOB_PRIORITY_HIGH = 1,
    BG_JOB_PRIORITY_NORMAL = 2,
    BG_JOB_PRIORITY_LOW = 3,
}

Public Enum BG_JOB_PRIORITY As Integer
    BG_JOB_PRIORITY_FOREGROUND = 0
    BG_JOB_PRIORITY_HIGH = 1
    BG_JOB_PRIORITY_NORMAL = 2
    BG_JOB_PRIORITY_LOW = 3
End Enum

import enum

class BG_JOB_PRIORITY(enum.IntEnum):
    BG_JOB_PRIORITY_FOREGROUND = 0
    BG_JOB_PRIORITY_HIGH = 1
    BG_JOB_PRIORITY_NORMAL = 2
    BG_JOB_PRIORITY_LOW = 3

// BG_JOB_PRIORITY
pub const BG_JOB_PRIORITY_FOREGROUND: i32 = 0;
pub const BG_JOB_PRIORITY_HIGH: i32 = 1;
pub const BG_JOB_PRIORITY_NORMAL: i32 = 2;
pub const BG_JOB_PRIORITY_LOW: i32 = 3;

// BG_JOB_PRIORITY
const (
	BG_JOB_PRIORITY_FOREGROUND int32 = 0
	BG_JOB_PRIORITY_HIGH int32 = 1
	BG_JOB_PRIORITY_NORMAL int32 = 2
	BG_JOB_PRIORITY_LOW int32 = 3
)

const
  BG_JOB_PRIORITY_FOREGROUND = 0;
  BG_JOB_PRIORITY_HIGH = 1;
  BG_JOB_PRIORITY_NORMAL = 2;
  BG_JOB_PRIORITY_LOW = 3;

// BG_JOB_PRIORITY
pub const BG_JOB_PRIORITY_FOREGROUND: i32 = 0;
pub const BG_JOB_PRIORITY_HIGH: i32 = 1;
pub const BG_JOB_PRIORITY_NORMAL: i32 = 2;
pub const BG_JOB_PRIORITY_LOW: i32 = 3;

const
  BG_JOB_PRIORITY_FOREGROUND* = 0
  BG_JOB_PRIORITY_HIGH* = 1
  BG_JOB_PRIORITY_NORMAL* = 2
  BG_JOB_PRIORITY_LOW* = 3

enum BG_JOB_PRIORITY : int {
    BG_JOB_PRIORITY_FOREGROUND = 0,
    BG_JOB_PRIORITY_HIGH = 1,
    BG_JOB_PRIORITY_NORMAL = 2,
    BG_JOB_PRIORITY_LOW = 3,
}

#define global BG_JOB_PRIORITY_FOREGROUND 0x0
#define global BG_JOB_PRIORITY_HIGH       0x1
#define global BG_JOB_PRIORITY_NORMAL     0x2
#define global BG_JOB_PRIORITY_LOW        0x3