Fungsi KeQueryGroupAffinity (wdm.h)

  • Artikel

Rutinitas KeQueryGroupAffinity mengembalikan masker afinitas yang mengidentifikasi prosesor logis aktif dalam grup tertentu dalam sistem multiprosesor.

Sintaks

KAFFINITY KeQueryGroupAffinity(
  [in] USHORT GroupNumber
);

Parameter

[in] GroupNumber

Nomor grup. Jika sistem multiprosedur berisi grup n , grup diberi nomor dari 0 hingga n-1. Untuk mendapatkan jumlah grup aktif dalam sistem, panggil rutinitas KeQueryActiveGroupCount .

Nilai kembali

KeQueryGroupAffinity mengembalikan nilai KAFFINITY yang mengidentifikasi prosesor logika aktif dalam grup yang ditentukan. Jika nilai parameter GroupNumber bukan nomor grup yang valid, rutinitas mengembalikan nol.

Keterangan

Rutinitas terkait, KeQueryActiveProcessors, mengembalikan masker afinitas yang mewakili serangkaian prosesor aktif, tetapi rutinitas ini, tidak seperti KeQueryGroupAffinity, tidak menerima nomor grup sebagai parameter input. Di Windows 7 dan versi yang lebih baru dari sistem operasi Windows, KeQueryActiveProcessors mengembalikan masker afinitas untuk 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 KeQueryActiveProcessors 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 KeQueryGroupAffinity alih-alih KeQueryActiveProcessors.

Persyaratan

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

Lihat juga

KAFINITAS

KeQueryActiveProcessors