struktur SYSTEM_CPU_SET_INFORMATION (winnt.h)

Struktur ini dikembalikan oleh GetSystemCpuSetInformation. Ini digunakan untuk menghitung Set CPU pada sistem dan menentukan statusnya saat ini.

Ini adalah struktur berukuran variabel yang dirancang untuk ekspansi di masa mendatang. Saat melakukan iterasi di atas struktur ini, gunakan bidang ukuran untuk menentukan offset ke struktur berikutnya.

Sintaks

typedef struct _SYSTEM_CPU_SET_INFORMATION {
  DWORD                    Size;
  CPU_SET_INFORMATION_TYPE Type;
  union {
    struct {
      DWORD   Id;
      WORD    Group;
      BYTE    LogicalProcessorIndex;
      BYTE    CoreIndex;
      BYTE    LastLevelCacheIndex;
      BYTE    NumaNodeIndex;
      BYTE    EfficiencyClass;
      union {
        BYTE AllFlags;
        struct {
          BYTE Parked : 1;
          BYTE Allocated : 1;
          BYTE AllocatedToTargetProcess : 1;
          BYTE RealTime : 1;
          BYTE ReservedFlags : 4;
        } DUMMYSTRUCTNAME;
      } DUMMYUNIONNAME2;
      union {
        DWORD Reserved;
        BYTE  SchedulingClass;
      };
      DWORD64 AllocationTag;
    } CpuSet;
  } DUMMYUNIONNAME;
} SYSTEM_CPU_SET_INFORMATION, *PSYSTEM_CPU_SET_INFORMATION;

Anggota

Size

Ini adalah ukuran, dalam byte, dari struktur informasi ini.

Type

Ini adalah jenis informasi dalam struktur. Aplikasi harus melewati struktur apa pun dengan jenis yang tidak dikenal.

DUMMYUNIONNAME

DUMMYUNIONNAME.CpuSet

DUMMYUNIONNAME.CpuSet.Id

ID Dari Set CPU yang ditentukan. Pengidentifikasi ini dapat digunakan dengan SetProcessDefaultCpuSets atau SetThreadSelectedCpuSets saat menentukan daftar Set CPU yang akan diakfinisikan.

DUMMYUNIONNAME.CpuSet.Group

Menentukan Grup Prosesor dari Set CPU. Semua nilai lain dalam struktur CpuSet relatif terhadap grup prosesor.

DUMMYUNIONNAME.CpuSet.LogicalProcessorIndex

Menentukan indeks relatif grup dari prosesor beranda Dari Set CPU. Kecuali Set CPU diparkir karena alasan manajemen termal atau daya atau ditetapkan untuk penggunaan eksklusif ke aplikasi lain, utas akan berjalan pada prosesor rumah dari salah satu Set CPU mereka. Bidang Group dan LogicalProcessorIndex sama dengan yang ditemukan dalam struktur PROCESSOR_NUMBER dan sesuai dengan bidang Grup dan bidang Mask dari struktur GROUP_AFFINITY.

DUMMYUNIONNAME.CpuSet.CoreIndex

Nilai relatif grup yang menunjukkan "Core" mana yang memiliki prosesor beranda Dari Set CPU. Angka ini sama untuk semua Set CPU dalam grup yang sama yang berbagi sumber daya eksekusi yang signifikan satu sama lain, seperti utas perangkat keras yang berbeda pada satu inti yang mendukung multi-utas simultan.

DUMMYUNIONNAME.CpuSet.LastLevelCacheIndex

Nilai relatif grup yang menunjukkan Kumpulan CPU mana yang berbagi setidaknya satu tingkat cache satu sama lain. Nilai ini sama untuk semua Set CPU dalam grup yang ada di prosesor yang berbagi cache satu sama lain.

DUMMYUNIONNAME.CpuSet.NumaNodeIndex

Nilai relatif grup yang menunjukkan simpul NUMA mana set CPU aktif. Semua Set CPU dalam grup tertentu yang berada pada simpul NUMA yang sama akan memiliki nilai yang sama untuk bidang ini.

DUMMYUNIONNAME.CpuSet.EfficiencyClass

Nilai yang menunjukkan efisiensi energi intrinsik dari prosesor untuk sistem yang mendukung prosesor heterogen (seperti ARM besar. SISTEM LITTLE). Set CPU dengan nilai numerik yang lebih tinggi dari bidang ini memiliki prosesor rumah yang lebih cepat tetapi kurang hemat daya daripada yang memiliki nilai yang lebih rendah.

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.AllFlags

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME.Parked

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME.Allocated

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME.AllocatedToTargetProcess

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME.RealTime

DUMMYUNIONNAME.CpuSet.DUMMYUNIONNAME2.DUMMYSTRUCTNAME.ReservedFlags

DUMMYUNIONNAME.CpuSet.Reserved

Dicadangkan.

DUMMYUNIONNAME.CpuSet.SchedulingClass

DUMMYUNIONNAME.CpuSet.AllocationTag

Menentukan tag yang digunakan oleh Alokasi Inti untuk mengomunikasikan Kumpulan CPU yang dialokasikan tertentu di antara utas dalam komponen yang berbeda.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2016 [aplikasi desktop | Aplikasi UWP]
Header	winnt.h (termasuk Windows.h)