estrutura KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT (wdm.h)
A estrutura KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT descreve o contexto de notificação 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 os seguintes:
KeProcessorAddStartNotify
O sistema operacional está prestes a adicionar o processador. Nesse estado, um driver de dispositivo que recebe essa notificação pode alocar quaisquer estruturas 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 que ele alocou para o novo processador quando recebeu 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 status de erro 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.
Observações
A estrutura de KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT está disponível a partir do Windows Server 2008.
Um driver de dispositivo se 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 registrar-se para esta notificação, consulte Registring for Synchronous Driver Notification.
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 de KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte a partir do Windows Server 2008. |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |