Fungsi GetNumaNodeProcessorMask2 (systemtopologyapi.h)

Mengambil masker prosesor multi-grup dari simpul yang ditentukan.

Sintaks

BOOL GetNumaNodeProcessorMask2(
  USHORT          NodeNumber,
  PGROUP_AFFINITY ProcessorMasks,
  USHORT          ProcessorMaskCount,
  PUSHORT         RequiredMaskCount
);

Parameter

NodeNumber

Memasok nomor simpul berbasis nol untuk simpul yang diminati.

ProcessorMasks

Array struktur GROUP_AFFINITY , yang setelah berhasil dikembalikan menjelaskan masker prosesor dari simpul yang ditentukan.

Setiap elemen dalam array menjelaskan sekumpulan prosesor yang termasuk dalam simpul dalam satu grup prosesor. Akan ada satu elemen dalam array yang dihasilkan untuk setiap grup prosesor tempat simpul ini memiliki prosesor aktif.

ProcessorMaskCount

Menentukan ukuran array ProcessorMasks , dalam elemen.

RequiredMaskCount

Pada pengembalian yang berhasil, menentukan jumlah struktur afinitas yang ditulis ke array.

Jika array input terlalu kecil, fungsi gagal dengan ERROR_INSUFFICIENT_BUFFER dan mengatur parameter RequiredMaskCount ke jumlah elemen yang diperlukan.

Jumlah elemen yang diperlukan selalu kurang dari atau sama dengan jumlah grup maksimum yang dikembalikan oleh GetMaximumProcessorGroupCount.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol dan informasi kesalahan yang diperluas dapat diambil dengan memanggil GetLastError.

Jika array yang disediakan terlalu kecil, nilai kesalahan ERROR_INSUFFICIENT_BUFFER dan parameter RequiredMaskCount diatur ke jumlah elemen yang diperlukan.

Jika NodeNumber yang disediakan tidak valid (yaitu lebih besar dari nilai yang dikembalikan oleh GetNumaHighestNodeNumber), nilai kesalahan ERROR_INVALID_PARAMETER.

Keterangan

Jika simpul yang ditentukan tidak memiliki prosesor apa pun yang terkait dengannya (yaitu hanya berisi memori atau periferal), maka RequiredMaskCount yang dikembalikan akan menjadi 0 dan tidak ada struktur yang akan ditulis ke array.

Persyaratan

Klien minimum yang didukung	Windows 10 Build 20348
Server minimum yang didukung	Windows 10 Build 20348
Header	systemtopologyapi.h

Lihat juga

GetMaximumProcessorGroupCount