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) |