struktur SYSTEM_LOGICAL_PROCESSOR_INFORMATION (winnt.h)

Artikel
03/04/2024

Menjelaskan hubungan antara set prosesor yang ditentukan. Struktur ini digunakan dengan fungsi GetLogicalProcessorInformation .

Sintaks

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;

Anggota

ProcessorMask

Masker prosesor yang mengidentifikasi prosesor yang dijelaskan oleh struktur ini. Masker prosesor sedikit vektor di mana setiap bit yang ditetapkan mewakili prosesor aktif dalam hubungan. Setidaknya satu bit akan diatur.

Pada sistem dengan lebih dari 64 prosesor, masker prosesor mengidentifikasi prosesor dalam satu grup prosesor.

Relationship

Hubungan antara prosesor yang diidentifikasi oleh nilai anggota ProcessorMask . Anggota ini bisa menjadi salah satu nilai LOGICAL_PROCESSOR_RELATIONSHIP berikut.

Nilai	Makna
RelationCache 2	Prosesor logis yang ditentukan berbagi cache. Anggota Cache berisi informasi tambahan. Windows Server 2003: Nilai ini tidak didukung sampai Windows Server 2003 dengan SP1 dan Windows XP Professional x64 Edition.
RelationNumaNode 1	Prosesor logis yang ditentukan adalah bagian dari simpul NUMA yang sama. Anggota NumaNode berisi informasi tambahan.
RelationProcessorCore 0	Prosesor logis yang ditentukan berbagi satu inti prosesor. Anggota ProcessorCore berisi informasi tambahan.
RelationProcessorPackage 3	Prosesor logis yang ditentukan berbagi paket fisik. Tidak ada informasi tambahan yang tersedia. Windows Server 2003 dan Windows XP Professional x64 Edition: Nilai ini tidak didukung sampai Windows Server 2003 dengan SP1 dan Windows XP dengan SP3.

Versi Windows yang akan datang dapat mendukung nilai tambahan untuk anggota Hubungan .

DUMMYUNIONNAME

DUMMYUNIONNAME.ProcessorCore

Struktur ini berisi data yang valid hanya jika anggota Hubungan adalah RelationProcessorCore.

DUMMYUNIONNAME.ProcessorCore.Flags

Jika nilai anggota ini adalah 1, prosesor logis yang diidentifikasi oleh nilai unit fungsional berbagi anggota ProcessorMask , seperti dalam Hyperthreading atau SMT. Jika tidak, prosesor logis yang diidentifikasi tidak berbagi unit fungsional.

Windows Server 2003 dan Windows XP Professional x64 Edition: Anggota ini juga 1 untuk inti yang berbagi paket fisik. Oleh karena itu, untuk menentukan apakah prosesor mendukung beberapa core atau hyperthreading pada sistem sebelum Windows Vista, gunakan instruksi CPUID.

DUMMYUNIONNAME.NumaNode

Struktur ini berisi data yang valid hanya jika anggota Hubungan adalah RelationNumaNode.

DUMMYUNIONNAME.NumaNode.NodeNumber

Mengidentifikasi simpul NUMA . Nilai yang valid dari parameter ini adalah 0 hingga angka node NUMA tertinggi inklusif. Sistem multiprosesor non-NUMA akan melaporkan bahwa semua prosesor milik satu simpul NUMA.

DUMMYUNIONNAME.Cache

Struktur CACHE_DESCRIPTOR yang mengidentifikasi karakteristik cache tertentu. Ada satu rekaman yang dikembalikan untuk setiap cache yang dilaporkan. Beberapa atau semua cache mungkin tidak dilaporkan, tergantung pada mekanisme yang digunakan oleh prosesor untuk mengidentifikasi cache-nya. Oleh karena itu, jangan berasumsi tidak adanya cache tertentu. Cache belum tentu dibagikan di antara prosesor logis.

Struktur ini berisi data yang valid hanya jika anggota Hubungan adalah RelationCache.

Windows Server 2003: Anggota ini tidak didukung sampai Windows Server 2003 dengan SP1 dan Windows XP Professional x64 Edition.

DUMMYUNIONNAME.Reserved[2]

Dicadangkan. Jangan gunakan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP Professional x64 Edition [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	winnt.h (termasuk Windows.h)

Lihat juga

CACHE_DESCRIPTOR

GetLogicalProcessorInformation

GetLogicalProcessorInformationEx

LOGICAL_PROCESSOR_RELATIONSHIP

SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX

Bagikan melalui