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 |
---|---|
|
Menonaktifkan pembaruan dinamis afinitas proses oleh sistem. |
|
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 |