estrutura KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT (wdm.h)

A estrutura KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT descreve o contexto de notificação que é passado para uma função de retorno de chamada registrada quando um novo processador é adicionado dinamicamente a uma partição de hardware.

Sintaxe

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;

Membros

State

O estado da operação de adição do processador. Os valores possíveis são:

KeProcessorAddStartNotify

O sistema operacional está prestes a adicionar o processador. Nesse estado, um driver de dispositivo que recebe essa notificação pode alocar qualquer estrutura de dados por processador e executar quaisquer outras tarefas necessárias para preparar o driver para execução no novo processador.

KeProcessorAddCompleteNotify

O sistema operacional adicionou com êxito o processador. Nesse estado, um driver de dispositivo que recebe essa notificação pode iniciar o agendamento de threads no novo processador.

KeProcessorAddFailureNotify

O sistema operacional falhou ao adicionar o processador. Se um driver de dispositivo receber essa notificação, ele deverá liberar todas as estruturas de dados por processador alocadas para o novo processador quando receber a notificação KeProcessorAddStartNotify .

NtNumber

O índice do processador do novo processador. Para obter informações sobre a relação entre um índice de processador e um número de processador, consulte KeGetProcessorNumberFromIndex.

Status

Se o membro State contiver KeProcessorAddFailureNotify, esse membro conterá o erro status que indica por que a operação de adição do processador falhou.

ProcNumber

O número do processador do novo processador. Esse membro é uma estrutura PROCESSOR_NUMBER que especifica um número de grupo e um número de processador relativo ao grupo.

Comentários

A estrutura KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT está disponível a partir do Windows Server 2008.

Um driver de dispositivo registra para receber notificação quando um novo processador é adicionado dinamicamente à partição de hardware chamando a função KeRegisterProcessorChangeCallback . Para obter mais informações sobre como se registrar para essa notificação, consulte Registrando-se para notificação de driver síncrono.

Quando um novo processador é adicionado dinamicamente à partição de hardware, o sistema operacional chama cada função de retorno de chamada registrada duas vezes. O sistema operacional chama cada função de retorno de chamada registrada pela primeira vez com o estado KeProcessorAddStartNotify e a segunda vez com o estado KeProcessorAddCompleteNotify ou o estado KeProcessorAddFailureNotify .

A função de retorno de chamada de um driver de dispositivo que recebe essas notificações não deve modificar o conteúdo da estrutura KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte a partir do Windows Server 2008.
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Confira também

KeGetProcessorNumberFromIndex

KeRegisterProcessorChangeCallback

PROCESSOR_NUMBER