Fungsi SetThreadIdealProcessorEx (processthreadsapi.h)
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 |