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)

Voir aussi

KeGetProcessorNumberFromIndex

KeRegisterProcessorChangeCallback

PROCESSOR_NUMBER