Fungsi KeQueryActiveGroupCount (wdm.h)

  • Artikel

Rutinitas KeQueryActiveGroupCount mengembalikan jumlah grup prosesor aktif dalam sistem multiprosesor.

Sintaks

USHORT KeQueryActiveGroupCount();

Mengembalikan nilai

KeQueryActiveGroupCount mengembalikan hitungan grup aktif.

Keterangan

Grup prosesor aktif jika berisi satu atau beberapa prosesor logis aktif.

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 melakukan pekerjaan pemrosesan atau menganggur. Dalam beberapa sistem, jumlah prosesor aktif mungkin tetap tidak berubah dari startup sistem untuk dimatikan. Di sistem lain, Windows mungkin menambahkan prosesor aktif secara dinamis saat sistem sedang berjalan. Windows tidak pernah menghapus prosesor aktif dari sistem.

Dengan demikian, jumlah prosesor aktif dalam sistem multiprosesor dapat meningkat antara startup sistem dan pematian, tetapi jumlah ini tidak pernah berkurang. Demikian pula, jumlah grup aktif dalam sistem dapat meningkat jika prosesor ditambahkan secara dinamis ke grup yang tidak aktif saat sistem berjalan. Jumlah grup aktif tidak pernah berkurang.

Sebaliknya, nilai yang dikembalikan oleh KeQueryMaximumGroupCount tetap konstan selama runtime. Nilai ini adalah jumlah maksimum grup yang dapat dimiliki sistem.

Panggil rutinitas KeQueryActiveProcessorCountEx untuk menentukan jumlah prosesor logika aktif dalam grup tertentu.

Windows 7 adalah versi pertama Windows yang mendukung grup prosesor. Di Windows 7, hanya Windows versi 64-bit yang mendukung beberapa grup; Versi Windows 32-bit hanya mendukung satu grup. Jika sistem multiprosesor menjalankan Windows versi 64-bit dan berisi tidak lebih dari 64 prosesor logis, Windows menetapkan semua prosesor ke grup 0. Sistem multiprosesor yang menjalankan Windows versi 32-bit dapat berisi tidak lebih dari 32 prosesor.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 7.
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

KeQueryActiveProcessorCountEx

KeQueryMaximumGroupCount