struktur KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT (wdm.h)

Struktur KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT menjelaskan konteks pemberitahuan yang diteruskan ke fungsi panggilan balik terdaftar saat prosesor baru ditambahkan secara dinamis ke partisi perangkat keras.

Sintaks

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;

Anggota

State

Status operasi penambahan prosesor. Kemungkinan nilainya adalah sebagai berikut:

KeProcessorAddStartNotify

Sistem operasi akan menambahkan prosesor. Pada status ini, driver perangkat yang menerima pemberitahuan ini dapat mengalokasikan struktur data per prosesor apa pun dan melakukan tugas lain yang diperlukan untuk mempersiapkan driver untuk dieksekusi pada prosesor baru.

KeProcessorAddCompleteNotify

Sistem operasi telah berhasil menambahkan prosesor. Pada status ini, driver perangkat yang menerima pemberitahuan ini dapat mulai menjadwalkan utas pada prosesor baru.

KeProcessorAddFailureNotify

Sistem operasi gagal menambahkan prosesor. Jika driver perangkat menerima pemberitahuan ini, itu harus membebaskan struktur data per prosesor yang dialokasikan untuk prosesor baru ketika menerima pemberitahuan KeProcessorAddStartNotify .

NtNumber

Indeks prosesor prosesor baru. Untuk informasi tentang hubungan antara indeks prosesor dan nomor prosesor, lihat KeGetProcessorNumberFromIndex.

Status

Jika anggota Status berisi KeProcessorAddFailureNotify, anggota ini berisi status kesalahan yang menunjukkan mengapa operasi penambahan prosesor gagal.

ProcNumber

Nomor prosesor prosesor baru. Anggota ini adalah struktur PROCESSOR_NUMBER yang menentukan nomor grup dan nomor prosesor relatif grup.

Keterangan

Struktur KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT tersedia dimulai dengan Windows Server 2008.

Driver perangkat mendaftar untuk menerima pemberitahuan ketika prosesor baru ditambahkan secara dinamis ke partisi perangkat keras dengan memanggil fungsi KeRegisterProcessorChangeCallback . Untuk informasi selengkapnya tentang mendaftar untuk pemberitahuan ini, lihat Mendaftar untuk Pemberitahuan Driver Sinkron.

Ketika prosesor baru ditambahkan secara dinamis ke partisi perangkat keras, sistem operasi memanggil setiap fungsi panggilan balik terdaftar dua kali. Sistem operasi memanggil setiap fungsi panggilan balik terdaftar untuk pertama kalinya dengan status KeProcessorAddStartNotify , dan kedua kalinya dengan status KeProcessorAddCompleteNotify atau status KeProcessorAddFailureNotify .

Fungsi panggilan balik driver perangkat yang menerima pemberitahuan ini tidak boleh mengubah konten struktur KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung dimulai dengan Windows Server 2008.
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)

Lihat juga

KeGetProcessorNumberFromIndex

KeRegisterProcessorChangeCallback

PROCESSOR_NUMBER