KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT 구조체(wdm.h)

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

상태 멤버에 KeProcessorAddFailureNotify가 포함된 경우 이 멤버에는 프로세서 추가 작업이 실패한 이유를 나타내는 오류 상태 포함됩니다.

ProcNumber

새 프로세서의 프로세서 번호입니다. 이 멤버는 그룹 번호와 그룹 상대 프로세서 번호를 지정하는 PROCESSOR_NUMBER 구조체입니다.

설명

KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT 구조는 Windows Server 2008부터 사용할 수 있습니다.

새 프로세서가 KeRegisterProcessorChangeCallback 함수를 호출하여 하드웨어 파티션에 동적으로 추가될 때 디바이스 드라이버가 알림을 수신하도록 등록합니다. 이 알림 등록에 대한 자세한 내용은 동기 드라이버 알림 등록을 참조하세요.

새 프로세서가 하드웨어 파티션에 동적으로 추가되면 운영 체제는 등록된 각 콜백 함수를 두 번 호출합니다. 운영 체제는 KeProcessorAddStartNotify 상태로 등록된 각 콜백 함수를 처음 호출하고, KeProcessorAddCompleteNotify 상태 또는 KeProcessorAddFailureNotify 상태로 두 번째로 호출합니다.

이러한 알림을 수신하는 디바이스 드라이버의 콜백 함수는 KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT 구조체의 내용을 수정해서는 안 됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Server 2008부터 지원됩니다.
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)

추가 정보

KeGetProcessorNumberFromIndex

KeRegisterProcessorChangeCallback

PROCESSOR_NUMBER