Funzione GetNumaNodeProcessorMaskEx (systemtopologyapi.h)

Articolo
03/02/2024

Recupera la maschera del processore per un nodo indipendentemente dal gruppo di processori a cui appartiene il nodo.

Sintassi

BOOL GetNumaNodeProcessorMaskEx(
  [in]  USHORT          Node,
  [out] PGROUP_AFFINITY ProcessorMask
);

Parametri

[in] Node

Numero del nodo.

[out] ProcessorMask

Puntatore a una struttura GROUP_AFFINITY che riceve la maschera del processore per il nodo specificato. Una maschera del processore è un vettore di bit in cui ogni bit rappresenta un processore e se si trova nel nodo.

Se il nodo specificato non dispone di processori configurati, il membro Mask è zero e il membro Group non è definito.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

La funzione GetNumaNodeProcessorMaskEx differisce da GetNumaNodeProcessorMask in quanto può recuperare la maschera del processore per un nodo indipendentemente dal gruppo a cui appartiene il nodo. Ovvero, il nodo non deve trovarsi nello stesso gruppo del thread chiamante. La funzione GetNumaNodeProcessorMask può recuperare la maschera del processore solo per i nodi che si trovano nello stesso gruppo del thread chiamante.

Per recuperare il nodo numerato più alto nel sistema, usare la funzione GetNumaHighestNodeNumber . Si noti che questo numero non è garantito che sia uguale al numero totale di nodi nel sistema.

Per assicurarsi che tutti i thread per il processo vengano eseguiti nello stesso nodo, usare la funzione SetProcessAffinityMask con una maschera di affinità di processo che specifica i processori nello stesso nodo.

Per compilare un'applicazione che usa questa funzione, impostare _WIN32_WINNT= 0x0601>. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Nota

A partire da TBD Release Iron, il comportamento di questa e di altre funzioni NUMA è stato modificato per supportare meglio i sistemi con nodi contenenti più di 64 processori. Per altre informazioni su questa modifica, incluse le informazioni sull'abilitazione del comportamento precedente di questa API, vedere Supporto NUMA.

Comportamento a partire da Iron versione TBD

A ogni nodo viene assegnato un gruppo primario dal sistema. Il GROUP_AFFINITY restituito da GetNumaNodeProcessorMaskEx riguarda il gruppo primario del nodo.

Comportamento nelle versioni precedenti

Viene restituito il GROUP_AFFINITY per il nodo specificato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	systemtopologyapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll