Partager via


IVirtualProcessorRoot::Activate, méthode

Implique que le proxy de thread associé au pContext d'interface du contexte d'exécution démarre l'exécution sur cette racine de processeur virtuel.

virtual void Activate(
   _Inout_ IExecutionContext * pContext
) =0;

Paramètres

  • pContext
    Interface au contexte d'exécution qui sera distribué sur cette racine de processeur virtuel.

Notes

Le Gestionnaire des ressources fournira un proxy de thread si aucun n'est associé à l'interface de contexte d'exécution pContext.

La méthode Activate peut être utilisée pour commencer l'exécution d'un travail sur une nouvelle racine de processeur virtuel retournée par le Gestionnaire de ressources ou pour reprendre le proxy de thread sur une racine de processeur virtuel désactivé ou sur le point de l'être.Consultez IVirtualProcessorRoot::Deactivate pour plus d'informations sur la désactivation.Lorsque vous reprenez une racine de processeur virtuel désactivée, le paramètre pContext doit être le même que le paramètre utilisé pour désactiver la racine de processeur virtuel.

Une fois une racine de processeur virtuel activée pour la première fois, les paires suivantes d'appels à Deactivate et Activate peuvent être en concurrence.Cela signifie que le Gestionnaire des ressources peut recevoir un appel à Activate avant de recevoir l'appel Deactivate prévu.

Lorsque vous activez une racine de processeur virtuel, vous signalez au Gestionnaire des ressources que cette racine de processeur virtuel est actuellement occupée.Si votre planificateur ne peut pas trouver de travail à exécuter sur cette racine, il est supposé appeler la méthode Deactivate qui informe le Gestionnaire de ressources que la racine de processeur virtuel est inactive.Le Gestionnaire des ressources utilise ces données pour équilibrer la charge du système.

invalid_argument est levé si l'argument pContext a la valeur NULL.

invalid_operation est levé si l'argument pContext ne représente pas le contexte d'exécution ayant été distribué le plus récemment par cette racine de processeur virtuel.

L'acte d'activation de la racine du processeur virtuel augmente le niveau d'abonnement du thread matériel sous-jacent de 1.Pour plus d'informations sur les niveaux d'abonnement, consultez IExecutionResource::CurrentSubscriptionLevel.

Configuration requise

En-tête : concrtrm.h

Accès concurrentiel del'espace de noms :

Voir aussi

Référence

IVirtualProcessorRoot, structure

IVirtualProcessorRoot::Deactivate, méthode

IExecutionResource::CurrentSubscriptionLevel, méthode