structure KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT (wdm.h)
La structure KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT décrit le contexte de notification passé à une fonction de rappel inscrite lorsqu’un nouveau processeur est ajouté dynamiquement à une partition matérielle.
Syntaxe
typedef struct _KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT {
KE_PROCESSOR_CHANGE_NOTIFY_STATE State;
ULONG NtNumber;
NTSTATUS Status;
PROCESSOR_NUMBER ProcNumber;
} KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT, *PKE_PROCESSOR_CHANGE_NOTIFY_CONTEXT;
Membres
State
État de l’opération d’ajout du processeur. Les valeurs possibles sont les suivantes :
KeProcessorAddStartNotify
Le système d’exploitation est sur le point d’ajouter le processeur. À cet état, un pilote de périphérique qui reçoit cette notification peut allouer toutes les structures de données par processeur et effectuer toutes les autres tâches requises pour préparer le pilote à l’exécution sur le nouveau processeur.
KeProcessorAddCompleteNotify
Le système d’exploitation a correctement ajouté le processeur. À cet état, un pilote de périphérique qui reçoit cette notification peut commencer à planifier des threads sur le nouveau processeur.
KeProcessorAddFailureNotify
Le système d’exploitation n’a pas pu ajouter le processeur. Si un pilote de périphérique reçoit cette notification, il doit libérer toutes les structures de données par processeur qu’il a allouées au nouveau processeur lorsqu’il a reçu la notification KeProcessorAddStartNotify .
NtNumber
Index du processeur du nouveau processeur. Pour plus d’informations sur la relation entre un index de processeur et un numéro de processeur, consultez KeGetProcessorNumberFromIndex.
Status
Si le membre State contient KeProcessorAddFailureNotify, ce membre contient l’erreur status qui indique la raison de l’échec de l’opération d’ajout du processeur.
ProcNumber
Numéro de processeur du nouveau processeur. Ce membre est une structure PROCESSOR_NUMBER qui spécifie un numéro de groupe et un numéro de processeur relatif au groupe.
Remarques
La structure KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT est disponible à partir de Windows Server 2008.
Un pilote de périphérique s’inscrit pour recevoir une notification lorsqu’un nouveau processeur est ajouté dynamiquement à la partition matérielle en appelant la fonction KeRegisterProcessorChangeCallback . Pour plus d’informations sur l’inscription à cette notification, consultez Inscription à la notification de pilote synchrone.
Lorsqu’un nouveau processeur est ajouté dynamiquement à la partition matérielle, le système d’exploitation appelle chaque fonction de rappel inscrite deux fois. Le système d’exploitation appelle chaque fonction de rappel inscrite la première fois avec l’état KeProcessorAddStartNotify , et la deuxième fois avec l’état KeProcessorAddCompleteNotify ou l’état KeProcessorAddFailureNotify .
La fonction de rappel d’un pilote de périphérique qui reçoit ces notifications ne doit pas modifier le contenu de la structure KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge à partir de Windows Server 2008. |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |