Fungsi GetNumaNodeProcessorMask (winbase.h)

Artikel
03/13/2024

Mengambil mask prosesor untuk simpul yang ditentukan.

Sintaks

BOOL GetNumaNodeProcessorMask(
  [in]  UCHAR      Node,
  [out] PULONGLONG ProcessorMask
);

Parameter

[in] Node

Jumlah simpul.

[out] ProcessorMask

Masker prosesor untuk simpul. Masker prosesor sedikit vektor di mana setiap bit mewakili prosesor dan apakah itu di simpul.

Jika simpul tidak memiliki prosesor yang dikonfigurasi, masker prosesor adalah nol.

Pada sistem dengan lebih dari 64 prosesor, parameter ini diatur ke masker prosesor untuk simpul hanya jika simpul berada dalam grup prosesor yang sama dengan utas panggilan. Jika tidak, parameter diatur ke nol.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Untuk mengambil simpul bernomor tertinggi dalam sistem, gunakan fungsi GetNumaHighestNodeNumber . Perhatikan bahwa jumlah 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.

Gunakan fungsi GetNumaNodeProcessorMaskEx untuk mengambil masker prosesor untuk node di grup prosesor apa pun.

Catatan

Dimulai dengan TBD Release Iron, perilaku ini dan fungsi NUMA lainnya telah dimodifikasi untuk mendukung sistem yang lebih baik dengan node 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. Masker yang dikembalikan oleh GetNumaNodeProcessorMask adalah untuk grup utama simpul dan hanya dikembalikan jika utas panggilan termasuk dalam grup tersebut.

Perilaku di versi sebelumnya

Masker untuk simpul yang ditentukan dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP Professional x64 Edition, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll