Fungsi GetNumaNodeProcessorMaskEx (systemtopologyapi.h)

Artikel
03/08/2023

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