Funzione GetNumaNodeProcessorMask (winbase.h)
Recupera la maschera del processore per il nodo specificato.
Sintassi
BOOL GetNumaNodeProcessorMask(
[in] UCHAR Node,
[out] PULONGLONG ProcessorMask
);
Parametri
[in] Node
Numero del nodo.
[out] ProcessorMask
Maschera del processore per il nodo. Una maschera del processore è un vettore di bit in cui ogni bit rappresenta un processore e se si trova nel nodo.
Se il nodo non dispone di processori configurati, la maschera del processore è zero.
Nei sistemi con più di 64 processori, questo parametro viene impostato sulla maschera del processore per il nodo solo se il nodo si trova nello stesso gruppo di processori del thread chiamante. In caso contrario, il parametro è impostato su zero.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
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.
Usare la funzione GetNumaNodeProcessorMaskEx per recuperare la maschera del processore per un nodo in qualsiasi gruppo di processori.
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. La maschera restituita da GetNumaNodeProcessorMask è relativa al gruppo primario del nodo e viene restituita solo se il thread chiamante appartiene a tale gruppo.
Comportamento nelle versioni precedenti
Viene restituita la maschera per il nodo specificato.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista, Windows XP Professional x64 Edition, Windows XP con SP2 [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |