estructura SYSTEM_LOGICAL_PROCESSOR_INFORMATION (winnt.h)

Describe la relación entre el conjunto de procesadores especificado. Esta estructura se usa con la función GetLogicalProcessorInformation .

Sintaxis

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;

Miembros

ProcessorMask

Máscara de procesador que identifica los procesadores descritos por esta estructura. Una máscara de procesador es un vector de bits en el que cada bit establecido representa un procesador activo en la relación. Se establecerá al menos un bit.

En un sistema con más de 64 procesadores, la máscara de procesador identifica los procesadores en un único grupo de procesadores.

Relationship

Relación entre los procesadores identificados por el valor del miembro ProcessorMask . Este miembro puede ser uno de los siguientes valores de LOGICAL_PROCESSOR_RELATIONSHIP .

Las versiones futuras de Windows pueden admitir valores adicionales para el miembro Relationship .

DUMMYUNIONNAME

DUMMYUNIONNAME.ProcessorCore

Esta estructura contiene datos válidos solo si el miembro Relationship es RelationProcessorCore.

DUMMYUNIONNAME.ProcessorCore.Flags

Si el valor de este miembro es 1, los procesadores lógicos identificados por el valor del miembro ProcessorMask comparten unidades funcionales, como en Hyperthreading o SMT. De lo contrario, los procesadores lógicos identificados no comparten unidades funcionales.

Windows Server 2003 y Windows XP Professional x64 Edition: Este miembro también es 1 para núcleos que comparten un paquete físico. Por lo tanto, para determinar si el procesador admite varios núcleos o hyperthreading en sistemas anteriores a Windows Vista, use la instrucción CPUID.

DUMMYUNIONNAME.NumaNode

Esta estructura contiene datos válidos solo si el miembro Relationship es RelationNumaNode.

DUMMYUNIONNAME.NumaNode.NodeNumber

Identifica el nodo NUMA . Los valores válidos de este parámetro son de 0 al número de nodo NUMA más alto incluido. Un sistema multiprocesador que no sea NUMA notificará que todos los procesadores pertenecen a un nodo NUMA.

DUMMYUNIONNAME.Cache

Estructura CACHE_DESCRIPTOR que identifica las características de una caché determinada. Hay un registro devuelto para cada caché notificada. Es posible que algunas o todas las memorias caché no se notifiquen, en función del mecanismo utilizado por el procesador para identificar sus cachés. Por lo tanto, no asuma la ausencia de ninguna caché determinada. Las memorias caché no se comparten necesariamente entre procesadores lógicos.

Esta estructura contiene datos válidos solo si el miembro Relationship es RelationCache.

Windows Server 2003: Este miembro no se admite hasta Windows Server 2003 con SP1 y Windows XP Professional x64 Edition.

DUMMYUNIONNAME.Reserved[2]

Reservado. No utilizar.

Requisitos

Consulte también

CACHE_DESCRIPTOR

GetLogicalProcessorInformation

GetLogicalProcessorInformationEx

LOGICAL_PROCESSOR_RELATIONSHIP

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX