Fungsi KeGetProcessorIndexFromNumber (wdm.h)

Rutinitas KeGetProcessorIndexFromNumber mengonversi nomor grup dan nomor prosesor relatif grup ke indeks prosesor systemwide.

Sintaksis

C++
ULONG KeGetProcessorIndexFromNumber(
  [in] PPROCESSOR_NUMBER ProcNumber
);

Parameter

[in] ProcNumber

Penunjuk ke struktur PROCESSOR_NUMBER yang dialokasikan pemanggil yang berisi nomor grup dan nomor prosesor relatif grup.

Mengembalikan nilai

KeGetProcessorIndexFromNumber mengembalikan indeks prosesor systemwide jika panggilan berhasil. Jika ProcNumber menunjuk ke nilai PROCESSOR_NUMBER yang tidak valid, rutinitas mengembalikan INVALID_PROCESSOR_INDEX, yang ditentukan dalam file header Wdm.h.

Komentar

Rutinitas ini diterima sebagai input struktur PROCESSOR_NUMBER yang mengidentifikasi prosesor berdasarkan nomor grupnya dan nomor prosesornya dalam grup. Nilai pengembalian 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 systemwide berkisar dari 0 hingga 127.

Untuk mendapatkan jumlah total prosesor logis aktif dalam sistem, panggil keQueryActiveProcessorCountEx rutin dan atur parameter GroupNumber rutin ini ke ALL_PROCESSOR_GROUPS.

Rutinitas KeGetProcessorNumberFromIndex mengonversi indeks prosesor systemwide menjadi nomor grup dan nomor prosesor relatif grup.

Persyaratan

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

Lihat juga

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER