Zamanlayıcı Sınıfı

Eşzamanlılık Çalışma Zamanı zamanlayıcısı için soyutlamayı temsil eder.

Sözdizimi

class Scheduler;

Üyeler

Korumalı Oluşturucular

Ad	Tanım
Scheduler	sınıfının bir nesnesi Scheduler yalnızca fabrika yöntemleri kullanılarak veya örtük olarak oluşturulabilir.
~Scheduler Yıkıcısı	Sınıfın Scheduler bir nesnesi, tüm dış başvuruları sona erdiğinde örtük olarak yok edilir.

Genel Yöntemler

Ad	Tanım
Attach	Zamanlayıcıyı çağıran bağlama ekler. Bu yöntem döndürdüğünde, çağıran bağlam zamanlayıcı tarafından yönetilir ve zamanlayıcı geçerli zamanlayıcı olur.
Oluştur	Davranışı parametresi tarafından _Policy açıklanan yeni bir zamanlayıcı oluşturur, zamanlayıcıya bir ilk başvuru yerleştirir ve buna bir işaretçi döndürür.
CreateScheduleGroup	Aşırı yüklendi. Zamanlayıcı içinde yeni bir zamanlama grubu oluşturur. parametresini _Placement alan sürüm, yeni oluşturulan zamanlama grubundaki görevlerin bu parametre tarafından belirtilen konumda yürütülmeye karşı taraflı olmasını sağlar.
GetNumberOfVirtualProcessors	Zamanlayıcı için geçerli sanal işlemci sayısını döndürür.
GetPolicy	Zamanlayıcının oluşturulduğu ilkenin bir kopyasını döndürür.
Kimlik	Zamanlayıcı için benzersiz bir tanımlayıcı döndürür.
IsAvailableLocation	Belirli bir konumun zamanlayıcıda kullanılabilir olup olmadığını belirler.
Başvuru	Zamanlayıcı başvuru sayısını artırır.
RegisterShutdownEvent	Zamanlayıcı kapandığında ve kendisini yok ettiğinde parametresinde _Event geçirilen Windows olay tanıtıcısının sinyal vermesine neden olur. Olay sinyallendiğinde zamanlayıcıya zamanlanmış olan tüm çalışmalar tamamlanır. Bu yöntemle birden çok kapatma olayı kaydedilebilir.
Sürüm	Zamanlayıcı başvuru sayısını azaltma.
ResetDefaultSchedulerPolicy	Varsayılan zamanlayıcı ilkesini çalışma zamanı varsayılanı olarak sıfırlar. Bir sonraki varsayılan zamanlayıcı oluşturulduğunda, çalışma zamanı varsayılan ilke ayarlarını kullanır.
ScheduleTask	Aşırı yüklendi. Zamanlayıcı içinde hafif bir görev zamanlar. Hafif görev, çalışma zamanı tarafından belirlenen bir zamanlama grubuna yerleştirilir. parametresini _Placement alan sürüm, görevin belirtilen konumda yürütülmeye yönelik sapmaya neden olur.
SetDefaultSchedulerPolicy	Kullanıcı tanımlı bir ilkenin varsayılan zamanlayıcıyı oluşturmak için kullanılmasına izin verir. Bu yöntem yalnızca işlem içinde varsayılan zamanlayıcı mevcut olmadığında çağrılabilir. Varsayılan ilke ayarlandıktan sonra, veya ResetDefaultSchedulerPolicy yöntemine SetDefaultSchedulerPolicy bir sonraki geçerli çağrıya kadar etkin kalır.

Açıklamalar

Eşzamanlılık Çalışma Zamanı zamanlayıcı, uygulamanız tarafından kuyruğa alınan çalışmayı yürütmek için iş parçacığı gibi işletim sistemi yürütme bağlamlarıyla eşlenen yürütme bağlamlarını kullanır. Herhangi bir zamanda, bir zamanlayıcının eşzamanlılık düzeyi Resource Manager tarafından kendisine verilen sanal işlemci sayısına eşittir. Sanal işlemci, bir işleme kaynağına yönelik bir soyutlamadır ve temel alınan sistemdeki bir donanım iş parçacığıyla eşler. Belirli bir zamanda sanal işlemcide yalnızca tek bir zamanlayıcı bağlamı yürütülebilir.

Eşzamanlılık Çalışma Zamanı, paralel çalışma yürütmek için işlem başına varsayılan bir zamanlayıcı oluşturur. Ayrıca kendi zamanlayıcı örneklerinizi oluşturabilir ve bu sınıfı kullanarak işleyebilirsiniz.

Devralma Hiyerarşisi

Scheduler

Gereksinimler

Üst bilgi: concrt.h

Ad alanı: eşzamanlılık

İliştir

Zamanlayıcıyı çağıran bağlama ekler. Bu yöntem döndürdüğünde, çağıran bağlam zamanlayıcı tarafından yönetilir ve zamanlayıcı geçerli zamanlayıcı olur.

virtual void Attach() = 0;

Açıklamalar

Zamanlayıcı eklemek, zamanlayıcıya örtük olarak bir başvuru yerleştirir.

Gelecekte bir noktada zamanlayıcının kapanmasına izin vermek için CurrentScheduler::D etach yöntemini çağırmanız gerekir.

Bu yöntem zaten farklı bir zamanlayıcıya eklenmiş bir bağlamdan çağrılırsa, var olan zamanlayıcı önceki zamanlayıcı olarak anımsanır ve yeni oluşturulan zamanlayıcı geçerli zamanlayıcı olur. Yöntemini daha sonraki bir noktada çağırdığınızda CurrentScheduler::Detach , önceki zamanlayıcı geçerli zamanlayıcı olarak geri yüklenir.

Bu zamanlayıcı, çağıran bağlamın geçerli zamanlayıcısıysa, bu yöntem improper_scheduler_attach bir özel durum oluşturur.

Oluşturma

Davranışı parametresi tarafından _Policy açıklanan yeni bir zamanlayıcı oluşturur, zamanlayıcıya bir ilk başvuru yerleştirir ve buna bir işaretçi döndürür.

static Scheduler* __cdecl Create(const SchedulerPolicy& _Policy);

Parametreler

_Ilkesi
Yeni oluşturulan zamanlayıcının davranışını açıklayan zamanlayıcı ilkesi.

İade Değeri

Yeni oluşturulan bir zamanlayıcının işaretçisi. Bu Scheduler nesnenin üzerine yerleştirilmiş bir ilk başvuru sayısı var.

Açıklamalar

yöntemiyle Create bir zamanlayıcı oluşturulduktan sonra, ilk başvuru sayısını kaldırmak ve zamanlayıcının Release kapanmasına izin vermek için gelecekte bir noktada yöntemini çağırmanız gerekir.

Bu yöntemle oluşturulan bir zamanlayıcı, çağıran bağlama eklenmez. Attach yöntemi kullanılarak bir bağlama eklenebilir.

Bu yöntem, scheduler_resource_allocation_error ve invalid_scheduler_policy_value gibi çeşitli özel durumlar oluşturabilir.

CreateScheduleGroup

Zamanlayıcı içinde yeni bir zamanlama grubu oluşturur. parametresini _Placement alan sürüm, yeni oluşturulan zamanlama grubundaki görevlerin bu parametre tarafından belirtilen konumda yürütülmeye karşı taraflı olmasını sağlar.

virtual ScheduleGroup* CreateScheduleGroup() = 0;

virtual ScheduleGroup* CreateScheduleGroup(location& _Placement) = 0;

Parametreler

_Yerleşim
Zamanlama grubundaki görevlerin yürütmeye sapma yapacağı bir konuma başvuru.

İade Değeri

Yeni oluşturulan zamanlama grubuna bir işaretçi. Bu ScheduleGroup nesnenin üzerine yerleştirilmiş bir ilk başvuru sayısı var.

Açıklamalar

Üzerinde çalışmayı zamanlama işlemini tamamladığınızda Release yöntemini bir zamanlama grubunda çağırmanız gerekir. Zamanlayıcı, kuyruğa alınan tüm çalışmalar tamamlandığında zamanlama grubunu yok eder.

Bu zamanlayıcıyı açıkça oluşturduysanız, başvurularınızı zamanlayıcıda yayınlamadan önce içindeki grupları zamanlamak için tüm başvuruları serbest bırakmanız gerektiğini unutmayın.

GetNumberOfVirtualProcessors

Zamanlayıcı için geçerli sanal işlemci sayısını döndürür.

virtual unsigned int GetNumberOfVirtualProcessors() const = 0;

İade Değeri

Zamanlayıcı için geçerli sanal işlemci sayısı.

GetPolicy

Zamanlayıcının oluşturulduğu ilkenin bir kopyasını döndürür.

virtual SchedulerPolicy GetPolicy() const = 0;

İade Değeri

Zamanlayıcının oluşturulduğu ilkenin bir kopyası.

Id

Zamanlayıcı için benzersiz bir tanımlayıcı döndürür.

virtual unsigned int Id() const = 0;

İade Değeri

Zamanlayıcı için benzersiz bir tanımlayıcı.

IsAvailableLocation

Belirli bir konumun zamanlayıcıda kullanılabilir olup olmadığını belirler.

virtual bool IsAvailableLocation(const location& _Placement) const = 0;

Parametreler

_Yerleşim
Zamanlayıcının sorgulandığı konuma başvuru.

İade Değeri

Bağımsız değişken tarafından _Placement belirtilen konumun zamanlayıcıda kullanılabilir olup olmadığını gösteren bir gösterge.

Açıklamalar

Dönüş değerinin, verilen konumun kullanılabilir olup olmadığını gösteren anlık bir örnekleme olduğunu unutmayın. Birden çok zamanlayıcının varlığında, dinamik kaynak yönetimi herhangi bir noktada zamanlayıcılara kaynak ekleyebilir veya kaynaklardan kaynak alabilir. Bu durumda, belirtilen konum kullanılabilirliği değiştirebilir.

Başvuru

Zamanlayıcı başvuru sayısını artırır.

virtual unsigned int Reference() = 0 ;

İade Değeri

Yeni artırılan başvuru sayısı.

Açıklamalar

Bu genellikle zamanlayıcının oluşturma ömrünü yönetmek için kullanılır. Bir zamanlayıcının başvuru sayısı sıfıra düştüğünde zamanlayıcı kapatılır ve zamanlayıcı üzerindeki tüm çalışmalar tamamlandıktan sonra kendini yok eder.

Yöntemi çağırmadan Reference önce başvuru sayısı sıfırsa ve çağrı zamanlayıcıya ait olmayan bir bağlamdan yapılıyorsa yöntemi bir improper_scheduler_reference özel durumu oluşturur.

RegisterShutdownEvent

Zamanlayıcı kapandığında ve kendisini yok ettiğinde parametresinde _Event geçirilen Windows olay tanıtıcısının sinyal vermesine neden olur. Olay sinyallendiğinde zamanlayıcıya zamanlanmış olan tüm çalışmalar tamamlanır. Bu yöntemle birden çok kapatma olayı kaydedilebilir.

virtual void RegisterShutdownEvent(HANDLE _Event) = 0;

Parametreler

_Olay
Zamanlayıcı kapandığında ve kendisini yok ettiğinde çalışma zamanı tarafından sinyal verilecek bir Windows olay nesnesinin tanıtıcısı.

Sürüm

Zamanlayıcı başvuru sayısını azaltma.

virtual unsigned int Release() = 0;

İade Değeri

Yeni azalan başvuru sayısı.

Açıklamalar

Bu genellikle zamanlayıcının oluşturma ömrünü yönetmek için kullanılır. Bir zamanlayıcının başvuru sayısı sıfıra düştüğünde zamanlayıcı kapatılır ve zamanlayıcı üzerindeki tüm çalışmalar tamamlandıktan sonra kendini yok eder.

ResetDefaultSchedulerPolicy

Varsayılan zamanlayıcı ilkesini çalışma zamanı varsayılanı olarak sıfırlar. Bir sonraki varsayılan zamanlayıcı oluşturulduğunda, çalışma zamanı varsayılan ilke ayarlarını kullanır.

static void __cdecl ResetDefaultSchedulerPolicy();

Açıklamalar

Bu yöntem, işlem içinde varsayılan bir zamanlayıcı varken çağrılabilir. Mevcut varsayılan zamanlayıcının ilkesini etkilemez. Ancak, varsayılan zamanlayıcı kapatılacaksa ve daha sonraki bir noktada yeni bir varsayılan oluşturulacaksa, yeni zamanlayıcı çalışma zamanı varsayılan ilke ayarlarını kullanır.

Scheduler

sınıfının bir nesnesi Scheduler yalnızca fabrika yöntemleri kullanılarak veya örtük olarak oluşturulabilir.

Scheduler();

Açıklamalar

Çağıran bağlama bir zamanlayıcı eklenmesini gerektiren çalışma zamanı işlevlerinin birçoğunu kullandığınızda, işlemin varsayılan zamanlayıcısı örtük olarak oluşturulur. PPL ve aracı katmanlarının sınıfı ve özellikleri içindeki CurrentScheduler yöntemler genellikle örtük ek gerçekleştirir.

Ayrıca, yöntemi veya Scheduler::Create yöntemi aracılığıyla CurrentScheduler::Create açıkça bir zamanlayıcı oluşturabilirsiniz.

~Zamanlayıcı

Sınıfın Scheduler bir nesnesi, tüm dış başvuruları sona erdiğinde örtük olarak yok edilir.

virtual ~Scheduler();

ScheduleTask

Zamanlayıcı içinde hafif bir görev zamanlar. Hafif görev, çalışma zamanı tarafından belirlenen bir zamanlama grubuna yerleştirilir. parametresini _Placement alan sürüm, görevin belirtilen konumda yürütülmeye yönelik sapmaya neden olur.

virtual void ScheduleTask(
    TaskProc _Proc,
    _Inout_opt_ void* _Data) = 0;

virtual void ScheduleTask(
    TaskProc _Proc,
    _Inout_opt_ void* _Data,
    location& _Placement) = 0;

Parametreler

_Yordam
Basit görevin gövdesini gerçekleştirmek için yürütülecek işlev işaretçisi.

_Veri
Görevin gövdesine parametre olarak geçirilecek verilere ilişkin geçersiz bir işaretçi.

_Yerleşim
Hafif görevin yürütülmeye karşı önyargılı olacağı bir konuma başvuru.

SetDefaultSchedulerPolicy

Kullanıcı tanımlı bir ilkenin varsayılan zamanlayıcıyı oluşturmak için kullanılmasına izin verir. Bu yöntem yalnızca işlem içinde varsayılan zamanlayıcı mevcut olmadığında çağrılabilir. Varsayılan ilke ayarlandıktan sonra, veya ResetDefaultSchedulerPolicy yöntemine SetDefaultSchedulerPolicy bir sonraki geçerli çağrıya kadar etkin kalır.

static void __cdecl SetDefaultSchedulerPolicy(const SchedulerPolicy& _Policy);

Parametreler

_Ilkesi
Varsayılan zamanlayıcı ilkesi olarak ayarlanacak ilke.

Açıklamalar

SetDefaultSchedulerPolicy yöntem, işlem içinde varsayılan bir zamanlayıcı zaten mevcut olduğunda çağrılırsa, çalışma zamanı bir default_scheduler_exists özel durumu oluşturur.

Ayrıca bkz.

Eşzamanlılık Ad Alanı
Zamanlayıcı Sınıfı
PolicyElementKey
Görev Zamanlayıcı