Fungsi KeGetCurrentProcessorNumberEx (ntddk.h)

Rutinitas KeGetCurrentProcessorNumberEx mendapatkan nomor prosesor prosesor logis yang dijalankan pemanggil.

Sintaks

ULONG KeGetCurrentProcessorNumberEx(
  [out, optional] PPROCESSOR_NUMBER ProcNumber
);

Parameter

[out, optional] ProcNumber

Penunjuk ke buffer yang dialokasikan pemanggil tempat rutin menulis struktur PROCESSOR_NUMBER yang mengidentifikasi prosesor logis saat ini. Struktur ini berisi nomor grup dan nomor prosesor relatif grup. Anda dapat mengatur parameter ini ke NULL jika Anda tidak memerlukan informasi ini.

Nilai kembali

KeGetCurrentProcessorNumberEx mengembalikan indeks prosesor systemwide dari prosesor logis yang dijalankan pemanggil.

Keterangan

Jika ProcNumber bukan NULL, buffer yang diacu oleh ProcNumber harus cukup besar untuk berisi struktur PROCESSOR_NUMBER. Berbeda dengan struktur ini, yang berisi nomor grup dan nomor prosesor relatif grup, nilai yang dikembalikan adalah indeks prosesor yang mengidentifikasi prosesor di seluruh sistem multiprosesor.

Misalnya, jika sistem multiprosesor berisi dua grup, dan setiap grup berisi 64 prosesor logis, nomor prosesor di setiap grup berkisar dari 0 hingga 63, tetapi indeks prosesor di seluruh sistem berkisar dari 0 hingga 127.

Rutinitas terkait, KeGetCurrentProcessorNumber, mengembalikan nomor prosesor saat ini, tetapi rutinitas ini, tidak seperti KeGetCurrentProcessorNumberEx, tidak menyediakan nomor grup untuk prosesor. Di Windows 7 dan versi yang lebih baru dari sistem operasi Windows, KeGetCurrentProcessorNumber mengembalikan nomor prosesor relatif grup jika pemanggil berjalan pada prosesor di grup 0, yang kompatibel dengan perilaku rutinitas ini di versi Windows sebelumnya yang tidak mendukung grup. Namun, jika pemanggil berjalan pada prosesor di grup mana pun selain grup 0, rutinitas ini mengembalikan angka yang kurang dari jumlah prosesor dalam grup 0. Perilaku ini memastikan bahwa nilai yang dikembalikan kurang dari nilai yang dikembalikan dari rutinitas KeQueryActiveProcessorCount . Driver yang ada yang memanggil KeGetCurrentProcessorNumber dan yang tidak menggunakan fitur berorientasi grup berjalan dengan benar dalam sistem multiprosedur yang memiliki dua grup atau lebih. Namun, driver yang menggunakan fitur berorientasi grup apa pun di Windows 7 dan versi yang lebih baru dari sistem operasi Windows harus memanggil KeGetCurrentProcessorNumberEx alih-alih KeGetCurrentProcessorNumber.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 7 dan versi Windows yang lebih baru.
Target Platform	Universal
Header	ntddk.h (termasuk Ntddk.h, Wdm.h, Ntddk.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Tingkat apa pun

Lihat juga

KeGetCurrentProcessorNumber

KeQueryActiveProcessorCount

PROCESSOR_NUMBER