Funzione GetNumaNodeProcessorMask (winbase.h)

Articolo
03/08/2023

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