GetNumaNodeProcessorMask2-Funktion (systemtopologyapi.h)

  • Artikel

Ruft die Prozessormaske für mehrere Gruppen des angegebenen Knotens ab.

Syntax

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

Parameter

NodeNumber

Stellt die nullbasierte Knotennummer für den relevanten Knoten bereit.

ProcessorMasks

Ein Array von GROUP_AFFINITY Strukturen, das bei erfolgreicher Rückgabe die Prozessormaske des angegebenen Knotens beschreibt.

Jedes Element im Array beschreibt eine Reihe von Prozessoren, die zum Knoten innerhalb einer einzelnen Prozessorgruppe gehören. Es gibt ein Element im resultierenden Array für jede Prozessorgruppe, in der dieser Knoten aktive Prozessoren enthält.

ProcessorMaskCount

Gibt die Größe des ProcessorMasks-Arrays in -Elementen an.

RequiredMaskCount

Gibt bei erfolgreicher Rückgabe die Anzahl der Affinitätsstrukturen an, die in das Array geschrieben werden.

Wenn das Eingabearray zu klein war, schlägt die Funktion mit ERROR_INSUFFICIENT_BUFFER fehl und legt den Parameter RequiredMaskCount auf die Anzahl der erforderlichen Elemente fest.

Die Anzahl der erforderlichen Elemente ist immer kleiner oder gleich der maximalen Gruppenanzahl, die von GetMaximumProcessorGroupCount zurückgegeben wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null, und erweiterte Fehlerinformationen können durch Aufrufen von GetLastError abgerufen werden.

Wenn das angegebene Array zu klein ist, wird der Fehlerwert ERROR_INSUFFICIENT_BUFFER und der Parameter RequiredMaskCount auf die Anzahl der erforderlichen Elemente festgelegt.

Wenn die angegebene NodeNumber ungültig ist (d. h. größer als der von GetNumaHighestNodeNumber zurückgegebene Wert), wird der Fehlerwert ERROR_INVALID_PARAMETER.

Hinweise

Wenn dem angegebenen Knoten keine Prozessoren zugeordnet sind (d. h. er enthält nur Arbeitsspeicher oder Peripheriegeräte), ist der zurückgegebene RequiredMaskCount 0, und es werden keine Strukturen in das Array geschrieben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10 Build 20348
Unterstützte Mindestversion (Server) Windows 10 Build 20348
Kopfzeile systemtopologyapi.h

Weitere Informationen

GetMaximumProcessorGroupCount