Fungsi SetThreadIdealProcessorEx (processthreadsapi.h)

  • Artikel

Mengatur prosesor ideal untuk utas yang ditentukan dan secara opsional mengambil prosesor ideal sebelumnya.

Sintaks

BOOL SetThreadIdealProcessorEx(
  [in]            HANDLE            hThread,
  [in]            PPROCESSOR_NUMBER lpIdealProcessor,
  [out, optional] PPROCESSOR_NUMBER lpPreviousIdealProcessor
);

Parameter

[in] hThread

Handel ke utas untuk mengatur prosesor ideal. Handel ini harus dibuat dengan hak akses THREAD_SET_INFORMATION. Untuk informasi selengkapnya, lihat Keamanan Utas dan Hak Akses.

[in] lpIdealProcessor

Penunjuk ke struktur PROCESSOR_NUMBER yang menentukan nomor prosesor prosesor ideal yang diinginkan.

[out, optional] lpPreviousIdealProcessor

Pointer ke struktur PROCESSOR_NUMBER untuk menerima prosesor ideal sebelumnya. Parameter ini dapat menunjuk ke lokasi memori yang sama dengan parameter lpIdealProcessor . Parameter ini bisa NULL jika prosesor ideal sebelumnya tidak diperlukan.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan nilai bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, gunakan GetLastError.

Keterangan

Menentukan prosesor ideal utas memberikan petunjuk kepada penjadwal tentang prosesor pilihan untuk utas. Penjadwal menjalankan utas pada prosesor ideal utas jika memungkinkan.

Dimulai dengan Windows 11 dan Windows Server 2022, pada sistem dengan lebih dari 64 prosesor, proses dan afinitas utas mencakup semua prosesor dalam sistem, di semua grup prosesor, secara default. SetThreadIdealProcessorEx, dalam mengatur prosesor pilihan, juga mengatur grup utama utas ke grup prosesor pilihan.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, atur _WIN32_WINNT >= 0x0601. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Windows Phone 8.1: Fungsi ini didukung untuk aplikasi Windows Phone Store di Windows Phone 8.1 dan yang lebih baru.

Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header processthreadsapi.h (termasuk Windows.h)
Pustaka Kernel32.lib; WindowsPhoneCore.lib di Windows Phone 8.1
DLL Kernel32.dll; KernelBase.dll pada Windows Phone 8.1

Lihat juga

GetThreadIdealProcessorEx

SetThreadIdealProcessor