Fungsi SetProcessAffinityUpdateMode (processthreadsapi.h)

Mengatur mode pembaruan afinitas dari proses yang ditentukan.

Sintaks

BOOL SetProcessAffinityUpdateMode(
  [in] HANDLE hProcess,
  [in] DWORD  dwFlags
);

Parameter

[in] hProcess

Handel untuk proses. Handel ini harus dikembalikan oleh fungsi GetCurrentProcess .

[in] dwFlags

Mode pembaruan afinitas. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Menonaktifkan pembaruan dinamis afinitas proses oleh sistem.
PROCESS_AFFINITY_ENABLE_AUTO_UPDATE 0x00000001UL	Memungkinkan pembaruan dinamis afinitas proses oleh sistem.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Sistem dapat menyesuaikan afinitas proses dalam berbagai kondisi, seperti ketika prosesor ditambahkan secara dinamis. Secara default, pembaruan dinamis untuk afinitas proses dinonaktifkan untuk setiap proses.

Proses harus menggunakan fungsi ini untuk menunjukkan apakah mereka dapat menangani penyesuaian dinamis afinitas proses oleh sistem. Setelah proses mengaktifkan mode pembaruan afinitas, ia dapat memanggil fungsi ini untuk menonaktifkannya. Namun, proses tidak dapat mengaktifkan mode pembaruan afinitas setelah menggunakan fungsi ini untuk menonaktifkannya.

Proses turunan tidak mewarisi mode pembaruan afinitas dari proses induk. Mode pembaruan afinitas harus diatur secara eksplisit untuk setiap proses anak.

Untuk mengkompilasi aplikasi yang memanggil fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	processthreadsapi.h (termasuk Windows.h pada Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

QueryProcessAffinityUpdateMode