Funzione GetNumaNodeProcessorMaskEx (systemtopologyapi.h)
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 |