排程器執行個體

本文將告訴您排程器 」 中的執行個體並行執行階段,以及如何使用角色 concurrency::Schedulerconcurrency::CurrentScheduler 來建立及管理排程器執行個體的類別。 當您要為明確的排程原則與特定類型的工作負載建立關聯時,排程器執行個體很實用。 例如,您可以建立一個排程器執行個體以更高的執行緒優先順序執行某些工作,而使用預設排程器以一般執行緒優先順序執行其他工作。

提示

並行執行階段提供了預設排程器,因此您不需要在應用程式中建立排程器。因為工作排程器有助於微調應用程式效能,如果您是並行執行階段的新使用者,建議請從平行模式程式庫 (PPL)非同步代理程式程式庫開始。

章節

  • Scheduler 和 CurrentScheduler 類別

  • 建立排程器執行個體

  • 管理排程器執行個體的存留期

  • 方法和功能

  • 範例

Scheduler 和 CurrentScheduler 類別

工作排程器可讓應用程式使用一個或多個「排程器執行個體」(Scheduler Instance) 來排程工作。 Concurrency::Scheduler 類別代表排程器執行個體,而封裝是否與排定的工作的功能。

附加至排程器的執行緒稱為「執行內容」(Execution Context),或簡稱為「內容」(Context)。 在目前的內容中,只有一個排程器可以在任何時間是作用中。 作用中的排程器又稱為「目前排程器」(Current Scheduler)。 並行執行階段會使用 concurrency::CurrentScheduler 能夠存取目前的排程器類別。 一項內容的目前排程器,可能會不同於另一項內容的目前排程器。 執行階段不會提供目前排程器的處理序層級表示。

CurrentScheduler 類別通常用以存取目前的排程器。 所要管理的排程器不是目前的排程器時,Scheduler 類別很實用。

下列章節將說明如何建立和管理排程器執行個體。 如需這些工作的完整範例,請參閱 HOW TO:管理排程器執行個體

Top

建立排程器執行個體

有三種方法可以建立 Scheduler 物件:

  • 如果沒有任何排程器,執行階段將會在您使用執行階段功能 (如平行演算法) 時為您建立預設排程器,以執行工作。 預設排程器會成為啟始平行工作之內容的目前排程器。

  • Concurrency::CurrentScheduler::Create 方法會建立Scheduler ,會使用特定的原則,並將該排程器與目前內容相關聯的物件。

  • Concurrency::Scheduler::Create 方法會建立Scheduler會使用特定的原則,但不會與目前內容關聯的物件。

如果允許執行階段建立預設排程器,將使所有的並行工作可共用相同的排程器。 平行模式程式庫 (PPL) 或非同步代理程式程式庫所提供的功能通常用以執行平行工作。 因此,您無須直接使用排程器來控制其原則或存留期。 當您使用 PPL 或代理程式程式庫時,執行階段會建立預設排程器 (如果不存在),並使其成為每項內容的目前排程器。 當您建立了排程器,並將它設為目前的排程器,執行階段就會使用該排程器來排定工作。 只有在您需要特定的排程原則時,建立其他排程器執行個體。 如需與排程器相關聯之原則的詳細資訊,請參閱排程器原則

Top

管理排程器執行個體的存留期

執行階段會使用參考計數機制,控制 Scheduler 物件的存留期。

當您使用 CurrentScheduler::Create 方法或 Scheduler::Create 方法建立 Scheduler 物件時,執行階段會將該排程器的初始參考計數設為 1。 執行階段會遞增參考次數,當您呼叫 concurrency::Scheduler::Attach 方法。 Scheduler::Attach 方法會建立 Scheduler 物件與目前內容的關聯。 這會使其成為目前的排程器。 當您呼叫 CurrentScheduler::Create 方法時,執行階段會建立 Scheduler 物件,並將其附加至目前的內容 (並將參考計數設為 1)。 您也可以使用 concurrency::Scheduler::Reference 方法,以遞增參考次數的Scheduler物件。

參考次數,當您呼叫的執行階段遞減 concurrency::CurrentScheduler::Detach 卸離目前的排程器] 的方法就是呼叫 concurrency::Scheduler::Release 方法。 當參考計數到達零時,執行階段會在所有的排程工作完成後終結 Scheduler 物件。 執行中的工作可遞增目前排程器的參考計數。 因此,如果參考計數到達零,而某項工作使參考計數遞增,則在參考計數再次到達零,且所有工作皆完成之前,執行階段將不會終結 Scheduler 物件。

執行階段會為每項內容維護 Scheduler 物件的內部堆疊。 當您呼叫 Scheduler::AttachCurrentScheduler::Create 方法時,執行階段會將該 Scheduler 物件推入到目前內容的堆疊上。 這會使其成為目前的排程器。 當您呼叫 CurrentScheduler::Detach 時,執行階段會從目前內容的堆疊快顯目前的排程器,並將前一個排程器設為目前的排程器。

執行階段有數種方式可管理排程器執行個體的存留期。 下表針對每個可為目前的內容建立或附加排程器的方法,列出可從目前的內容釋放排程器或中斷排程器連結的適當方法。

建立或附加方法

釋放或中斷連結方法

CurrentScheduler::Create

CurrentScheduler::Detach

Scheduler::Create

Scheduler::Release

Scheduler::Attach

CurrentScheduler::Detach

Scheduler::Reference

Scheduler::Release

呼叫不當的釋放或中斷連結方法,會在執行階段中產生未指定的行為。

當您使用會使執行階段為您建立預設排程器的功能 (如 PPL) 時,請不要釋放這個排程器或中斷其連結。 執行階段對於任何它所建立的排程器,都會管理其存留期。

因為執行階段不會終結Scheduler物件的所有任務都完成之前,您可以使用 concurrency::Scheduler::RegisterShutdownEvent 方法或 concurrency::CurrentScheduler::RegisterShutdownEvent 方法以接收通知時Scheduler在終結物件。 如果您必須等候 Scheduler 物件所排程的每項工作完成作業,這會很有用。

Top

方法和功能

本節摘要了 CurrentSchedulerScheduler 類別的重要方法。

請將 CurrentScheduler 類別視為輔助工具,用以建立目前的內容所使用的排程器。 Scheduler 類別可讓您控制屬於另一個內容的排程器。

下表列出 CurrentScheduler 類別所定義的重要方法。

方法

描述

Create

建立會使用特定原則的 Scheduler 物件,並建立此物件與目前內容的關聯。

Get

擷取與目前的內容關聯之 Scheduler 物件的指標。 這個方法不會遞增 Scheduler 物件的參考計數。

中斷連結

從目前的內容中斷目前排程器的連結,並將前一個排程器設為目前的排程器。

RegisterShutdownEvent

在目前的排程器終結時,註冊執行階段所設定的事件。

CreateScheduleGroup

會建立 concurrency::ScheduleGroup 在目前的排程器 」 中的物件。

ScheduleTask

新增輕量型工作至目前排程器的排程佇列中。

GetPolicy

擷取與目前的排程器相關聯的原則複本。

下表列出 Scheduler 類別所定義的重要方法。

方法

描述

Create

建立會使用指定原則的 Scheduler 物件。

附加

建立 Scheduler 物件與目前內容的關聯。

參考資料

遞增 Scheduler 物件的參考計數器。

Release

遞減 Scheduler 物件的參考計數器。

RegisterShutdownEvent

Scheduler 物件終結時,註冊執行階段所設定的事件。

CreateScheduleGroup

會建立 concurrency::ScheduleGroup 物件在Scheduler物件。

ScheduleTask

Scheduler 物件排程輕量型工作。

GetPolicy

擷取與 Scheduler 物件相關聯的原則複本。

SetDefaultSchedulerPolicy

設定執行階段在建立預設排程器時所使用的原則。

ResetDefaultSchedulerPolicy

將預設原則還原成呼叫 SetDefaultSchedulerPolicy 前的作用中原則。 如果預設排程器是在這個呼叫之後所建立的,執行階段將會使用預設原則設定來建立排程器。

Top

範例

如需如何建立和管理排程器執行個體的基本範例,請參閱 HOW TO:管理排程器執行個體

請參閱

工作

HOW TO:管理排程器執行個體

概念

工作排程器 (並行執行階段)

排程器原則

排程群組