структура KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT (wdm.h)

Статья
08/08/2023

Структура KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT описывает контекст уведомления, который передается зарегистрированной функции обратного вызова при динамическом добавлении нового процессора в аппаратный раздел.

Синтаксис

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;

Члены

State

Состояние операции добавления процессора. Возможные значения:

KeProcessorAddStartNotify

Операционная система вот-вот добавит процессор. В этом состоянии драйвер устройства, получающий это уведомление, может выделять любые структуры данных для каждого процессора и выполнять любые другие необходимые задачи для подготовки драйвера к выполнению на новом процессоре.

KeProcessorAddCompleteNotify

Операционная система успешно добавила процессор. В этом состоянии драйвер устройства, получающий это уведомление, может начать планирование потоков на новом процессоре.

KeProcessorAddFailureNotify

Операционной системе не удалось добавить процессор. Если драйвер устройства получает это уведомление, он должен освободить все структуры данных для каждого процессора, выделенные для нового процессора при получении уведомления KeProcessorAddStartNotify .

NtNumber

Индекс нового процессора. Сведения о связи между индексом процессора и номером процессора см. в разделе KeGetProcessorNumberFromIndex.

Status

Если элемент State содержит KeProcessorAddFailureNotify, этот элемент содержит состояние ошибки, указывающее, почему произошел сбой операции добавления процессора.

ProcNumber

Номер нового процессора. Этот элемент представляет собой PROCESSOR_NUMBER структуру, которая задает номер группы и номер процессора, относящегося к группе.

Драйвер устройства регистрируется для получения уведомлений при динамическом добавлении нового процессора в раздел оборудования путем вызова функции KeRegisterProcessorChangeCallback . Дополнительные сведения о регистрации для получения этого уведомления см. в разделе Регистрация для уведомления синхронного драйвера.

При динамическом добавлении нового процессора в аппаратный раздел операционная система вызывает каждую зарегистрированную функцию обратного вызова два раза. Операционная система вызывает каждую зарегистрированную функцию обратного вызова в первый раз с состоянием KeProcessorAddStartNotify , а во второй раз — с состоянием KeProcessorAddCompleteNotify или с состоянием KeProcessorAddFailureNotify .

Функция обратного вызова драйвера устройства, которая получает эти уведомления, не должна изменять содержимое структуры KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT .

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается начиная с Windows Server 2008.
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)

См. также раздел

KeGetProcessorNumberFromIndex

KeRegisterProcessorChangeCallback

PROCESSOR_NUMBER