Fungsi KeQueryActiveProcessorCountEx (wdm.h)

  • Artikel

Rutinitas KeQueryActiveProcessorCountEx mengembalikan jumlah prosesor logis aktif dalam grup tertentu dalam sistem multiprosesor atau di seluruh sistem.

Sintaks

ULONG KeQueryActiveProcessorCountEx(
  [in] USHORT GroupNumber
);

Parameter

[in] GroupNumber

Nomor grup. Jika sistem multiproscessor berisi grup n , nomor grup yang valid berkisar antara 0 hingga n-1. Untuk menghitung semua prosesor aktif di semua grup dalam sistem, atur parameter ini ke ALL_PROCESSOR_GROUPS, yang didefinisikan dalam file header Winnt.h dan Ntdef.h.

Nilai kembali

KeQueryActiveProcessorCountEx mengembalikan jumlah prosesor logika aktif dalam grup. Jika GroupNumber bukan nomor grup yang valid dan tidak ALL_PROCESSOR_GROUPS, groupNumber mengembalikan nol.

Keterangan

Prosesor logis aktif adalah prosesor logis yang telah dimulai dan ditambahkan Windows ke sistem multiprosesor. Istilah prosesor aktif berlaku untuk prosesor yang tersedia untuk melakukan pekerjaan pemrosesan, terlepas dari apakah prosesor saat ini sedang melakukan pekerjaan pemrosesan atau menganggur. Di beberapa sistem, jumlah prosesor aktif mungkin tetap tidak berubah dari startup sistem untuk dimatikan. Di sistem lain, Windows mungkin secara dinamis menambahkan prosesor aktif saat sistem berjalan. Windows tidak pernah menghapus prosesor aktif dari sistem. Dengan demikian, jumlah prosesor aktif dalam sistem multiprosesor dapat meningkat antara pengaktifan dan pematian sistem, tetapi jumlah ini tidak pernah berkurang.

Rutinitas terkait, KeQueryActiveProcessorCount, mengembalikan jumlah prosesor aktif, tetapi rutinitas ini, tidak seperti KeQueryActiveProcessorCountEx, tidak menerima nomor grup sebagai parameter input. Di Windows 7 dan versi yang lebih baru dari sistem operasi Windows, KeQueryActiveProcessorCount mengembalikan jumlah prosesor aktif di grup 0, yang kompatibel dengan perilaku rutinitas ini di versi Windows sebelumnya yang tidak mendukung grup. Perilaku ini memastikan bahwa driver yang ada yang memanggil KeQueryActiveProcessorCount dan yang tidak menggunakan fitur berorientasi grup akan 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 KeQueryActiveProcessorCountEx alih-alih KeQueryActiveProcessorCount.

Untuk contoh kode yang menggunakan KeQueryActiveProcessorCountEx, lihat KeGetProcessorNumberFromIndex.

Persyaratan

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

Lihat juga

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCount