struttura SYSTEM_LOGICAL_PROCESSOR_INFORMATION (winnt.h)

Articolo
08/27/2023

Descrive la relazione tra il set di processori specificato. Questa struttura viene usata con la funzione GetLogicalProcessorInformation .

Sintassi

typedef struct _SYSTEM_LOGICAL_PROCESSOR_INFORMATION {
  ULONG_PTR                      ProcessorMask;
  LOGICAL_PROCESSOR_RELATIONSHIP Relationship;
  union {
    struct {
      BYTE Flags;
    } ProcessorCore;
    struct {
      DWORD NodeNumber;
    } NumaNode;
    CACHE_DESCRIPTOR Cache;
    ULONGLONG        Reserved[2];
  } DUMMYUNIONNAME;
} SYSTEM_LOGICAL_PROCESSOR_INFORMATION, *PSYSTEM_LOGICAL_PROCESSOR_INFORMATION;

Members

ProcessorMask

Maschera del processore che identifica i processori descritti da questa struttura. Una maschera del processore è un vettore di bit in cui ogni bit del set rappresenta un processore attivo nella relazione. Verranno impostati almeno un bit.

In un sistema con più di 64 processori, la maschera del processore identifica i processori in un singolo gruppo di processori.

Relationship

Relazione tra i processori identificati dal valore del membro ProcessorMask . Questo membro può essere uno dei valori di LOGICAL_PROCESSOR_RELATIONSHIP seguenti.

Valore	Significato
RelationCache 2	I processori logici specificati condividono una cache. Il membro cache contiene informazioni aggiuntive. Windows Server 2003: Questo valore non è supportato fino a Windows Server 2003 con SP1 e Windows XP Professional x64 Edition.
RelationNumaNode 1	I processori logici specificati fanno parte dello stesso nodo NUMA. Il membro NumaNode contiene informazioni aggiuntive.
RelationProcessorCore 0	I processori logici specificati condividono un singolo core del processore. Il membro ProcessorCore contiene informazioni aggiuntive.
RelationProcessorPackage 3	I processori logici specificati condividono un pacchetto fisico. Non sono disponibili informazioni aggiuntive. Windows Server 2003 e Windows XP Professional x64 Edition: Questo valore non è supportato fino a Windows Server 2003 con SP1 e Windows XP con SP3.

Le versioni future di Windows possono supportare valori aggiuntivi per il membro Relationship .

DUMMYUNIONNAME

DUMMYUNIONNAME.ProcessorCore

Questa struttura contiene dati validi solo se il membro Relationship è RelationProcessorCore.

DUMMYUNIONNAME.ProcessorCore.Flags

Se il valore di questo membro è 1, i processori logici identificati dal valore del membro ProcessorMask condividono unità funzionali, come in Hyperthreading o SMT. In caso contrario, i processori logici identificati non condividono unità funzionali.

Windows Server 2003 e Windows XP Professional x64 Edition: Questo membro è anche 1 per i core che condividono un pacchetto fisico. Pertanto, per determinare se il processore supporta più core o hyperthreading nei sistemi precedenti a Windows Vista, usare l'istruzione CPUID.

DUMMYUNIONNAME.NumaNode

Questa struttura contiene dati validi solo se il membro Relationship è RelationNumaNode.

DUMMYUNIONNAME.NumaNode.NodeNumber

Identifica il nodo NUMA . I valori validi di questo parametro sono compresi tra 0 e il numero di nodo NUMA più alto incluso. Un sistema multiprocessore non NUMA segnala che tutti i processori appartengono a un nodo NUMA.

DUMMYUNIONNAME.Cache

Struttura CACHE_DESCRIPTOR che identifica le caratteristiche di una particolare cache. È presente un record restituito per ogni cache segnalata. Alcune o tutte le cache potrebbero non essere segnalate, a seconda del meccanismo usato dal processore per identificare le cache. Pertanto, non presupporre l'assenza di particolari cache. Le cache non sono necessariamente condivise tra processori logici.

Questa struttura contiene dati validi solo se il membro Relationship è RelationCache.

Windows Server 2003: Questo membro non è supportato fino a Windows Server 2003 con SP1 e Windows XP Professional x64 Edition.

DUMMYUNIONNAME.Reserved[2]

Riservato. Non usare.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP Professional x64 Edition [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	winnt.h (include Windows.h)

Vedi anche

CACHE_DESCRIPTOR

GetLogicalProcessorInformation

GetLogicalProcessorInformationEx

LOGICAL_PROCESSOR_RELATIONSHIP

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX

Condividi tramite