Fungsi GetNumaNodeProcessorMaskEx (systemtopologyapi.h)
Mengambil masker prosesor untuk node terlepas dari grup prosesor tempat simpul berada.
Sintaks
BOOL GetNumaNodeProcessorMaskEx(
[in] USHORT Node,
[out] PGROUP_AFFINITY ProcessorMask
);
Parameter
[in] Node
Nomor node.
[out] ProcessorMask
Penunjuk ke struktur GROUP_AFFINITY yang menerima masker prosesor untuk simpul yang ditentukan. Masker prosesor sedikit vektor di mana setiap bit mewakili prosesor dan apakah itu di simpul.
Jika simpul yang ditentukan tidak memiliki prosesor yang dikonfigurasi, anggota Masker adalah nol dan anggota Grup tidak terdefinis.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
Fungsi GetNumaNodeProcessorMaskEx berbeda dari GetNumaNodeProcessorMask karena dapat mengambil masker prosesor untuk node terlepas dari grup tempat simpul berada. Artinya, simpul tidak harus berada dalam grup yang sama dengan utas panggilan. Fungsi GetNumaNodeProcessorMask dapat mengambil mask prosesor hanya untuk simpul yang berada dalam grup yang sama dengan utas panggilan.
Untuk mengambil simpul bernomor tertinggi dalam sistem, gunakan fungsi GetNumaHighestNodeNumber . Perhatikan bahwa angka ini tidak dijamin sama dengan jumlah total simpul dalam sistem.
Untuk memastikan bahwa semua utas untuk proses Anda berjalan pada simpul yang sama, gunakan fungsi SetProcessAffinityMask dengan masker afinitas proses yang menentukan prosesor dalam simpul yang sama.
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, atur _WIN32_WINNT>= 0x0601. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.
Catatan
Dimulai dengan TBD Release Iron, perilaku fungsi NUMA ini dan lainnya telah dimodifikasi untuk mendukung sistem dengan lebih baik dengan simpul yang berisi lebih dari 64 prosesor. Untuk informasi selengkapnya tentang perubahan ini, termasuk informasi tentang mengaktifkan perilaku lama API ini, lihat Dukungan NUMA.
Perilaku yang dimulai dengan Besi Rilis TBD
Setiap simpul diberi grup utama oleh sistem. GROUP_AFFINITY yang dikembalikan oleh GetNumaNodeProcessorMaskEx adalah untuk grup utama simpul.
Perilaku dalam versi sebelumnya
GROUP_AFFINITY untuk simpul yang ditentukan dikembalikan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | systemtopologyapi.h (termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |