IResourceManager::RegisterScheduler, méthode

Article
03/04/2013

Inscrit un planificateur auprès du Gestionnaire de ressources.Une fois le planificateur inscrit, il doit communiquer avec le Gestionnaire de ressources à l'aide de l'interface ISchedulerProxy retournée.

virtual ISchedulerProxy *RegisterScheduler(
   _Inout_ IScheduler * pScheduler,
   unsigned int version
) =0;

Paramètres

pScheduler
Interface IScheduler au planificateur à enregistrer.
version
Version de l'interface de communication que le planificateur utilise pour communiquer avec le Gestionnaire des ressources.L'utilisation d'une version permet au Gestionnaire des ressources de faire évoluer l'interface de communication tout en permettant aux planificateurs d'obtenir l'accès aux fonctionnalités plus anciennes.Les planificateurs qui souhaitent utiliser des fonctionnalités du Gestionnaire de ressources dans Visual Studio 2010 doivent utiliser la version CONCRT_RM_VERSION_1.

Valeur de retour

Interface ISchedulerProxy que le Gestionnaire des ressources a associé à votre planificateur.Votre planificateur doit désormais utiliser cette interface pour communiquer avec le Gestionnaire des ressources.

Notes

Utilisez cette méthode pour initialiser la communication avec le Gestionnaire des ressources.La méthode associe l'interface IScheduler de votre planificateur à une interface ISchedulerProxy et vous la présente.Vous pouvez utiliser l'interface retournée pour demander des ressources d'exécution qui seront utilisées par votre planificateur, ou abonner des threads auprès du Gestionnaire des ressources.Le Gestionnaire des ressources utilisera les éléments de la stratégie du planificateur retournée par la méthode IScheduler::GetPolicy pour déterminer le type de threads pour lequel le planificateur devra exécuter un travail.Si votre clé de stratégie SchedulerKind a la valeur UmsThreadDefault et si la valeur est lue en dehors de la stratégie en tant que valeur UmsThreadDefault, l'interface IScheduler passée à la méthode doit être une interface IUMSScheduler.

La méthode lève une exception invalid_argument si le paramètre pScheduler a la valeur NULL ou si le paramètre version n'est pas une version valide pour l'interface de communication.