Funzione GetNumaNodeProcessorMask2 (systemtopologyapi.h)
Recupera la maschera del processore multi-gruppo del nodo specificato.
Sintassi
BOOL GetNumaNodeProcessorMask2(
USHORT NodeNumber,
PGROUP_AFFINITY ProcessorMasks,
USHORT ProcessorMaskCount,
PUSHORT RequiredMaskCount
);
Parametri
NodeNumber
Specifica il numero di nodo in base zero per il nodo di interesse.
ProcessorMasks
Matrice di strutture GROUP_AFFINITY , che al termine della restituzione descrive la maschera del processore del nodo specificato.
Ogni elemento della matrice descrive un set di processori che appartengono al nodo all'interno di un singolo gruppo di processori. Sarà presente un elemento nella matrice risultante per ogni gruppo di processori in cui questo nodo include processori attivi.
ProcessorMaskCount
Specifica le dimensioni della matrice ProcessorMasks , negli elementi.
RequiredMaskCount
In caso di esito positivo, specifica il numero di strutture di affinità scritte nella matrice.
Se la matrice di input è troppo piccola, la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER e imposta il parametro RequiredMaskCount sul numero di elementi necessari.
Il numero di elementi necessari è sempre minore o uguale al numero massimo di gruppi restituito da GetMaximumProcessorGroupCount.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero e le informazioni di errore estese possono essere recuperate chiamando GetLastError.
Se la matrice specificata è troppo piccola, il valore di errore è ERROR_INSUFFICIENT_BUFFER e il parametro RequiredMaskCount è impostato sul numero di elementi necessari.
Se NodeNumber fornito non è valido(ad esempio maggiore del valore restituito da GetNumaHighestNodeNumber ), il valore di errore è ERROR_INVALID_PARAMETER.
Commenti
Se il nodo specificato non dispone di processori associati a esso (ad esempio contiene solo memoria o periferiche), il valore RequiredMaskCount restituito sarà 0 e nessuna struttura verrà scritta nella matrice.
Requisiti
| Client minimo supportato | Windows 10 Build 20348 |
| Server minimo supportato | Windows 10 Build 20348 |
| Intestazione | systemtopologyapi.h |