Fungsi KeGetProcessorIndexFromNumber (ntifs.h)

  • Artikel

Rutinitas KeGetProcessorIndexFromNumber mengonversi nomor grup dan nomor prosesor relatif grup menjadi indeks prosesor di seluruh sistem.

Sintaks

ULONG KeGetProcessorIndexFromNumber(
  [in] PPROCESSOR_NUMBER ProcNumber
);

Parameter

[in] ProcNumber

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

Nilai kembali

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

Keterangan

Rutinitas ini diterima sebagai input struktur PROCESSOR_NUMBER yang mengidentifikasi prosesor berdasarkan nomor grupnya dan nomor prosesornya dalam 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.

Untuk mendapatkan jumlah total prosesor logis aktif dalam sistem, panggil rutinitas KeQueryActiveProcessorCountEx 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

Persyaratan Nilai
Klien minimum yang didukung Windows 7
Target Platform Universal
Header ntifs.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Tingkat apa pun

Lihat juga

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER