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

Vedi anche

GetMaximumProcessorGroupCount