Funzione SetProcessAffinityUpdateMode (processthreadsapi.h)
Imposta la modalità di aggiornamento dell'affinità del processo specificato.
Sintassi
BOOL SetProcessAffinityUpdateMode(
[in] HANDLE hProcess,
[in] DWORD dwFlags
);
Parametri
[in] hProcess
Handle per il processo. Questo handle deve essere restituito dalla funzione GetCurrentProcess .
[in] dwFlags
Modalità di aggiornamento dell'affinità. Questo parametro può avere uno dei valori seguenti.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Il sistema può modificare l'affinità di processo in diverse condizioni, ad esempio quando viene aggiunto un processore in modo dinamico. Per impostazione predefinita, gli aggiornamenti dinamici all'affinità del processo sono disabilitati per ogni processo.
I processi devono usare questa funzione per indicare se possono gestire la regolazione dinamica dell'affinità di processo dal sistema. Dopo che un processo abilita la modalità di aggiornamento dell'affinità, può chiamare questa funzione per disabilitarla. Tuttavia, un processo non può abilitare la modalità di aggiornamento dell'affinità dopo aver usato questa funzione per disabilitarla.
I processi figlio non ereditano la modalità di aggiornamento affinità del processo padre. La modalità di aggiornamento dell'affinità deve essere impostata in modo esplicito per ogni processo figlio.
Per compilare un'applicazione che chiama questa funzione, definire _WIN32_WINNT come 0x0600 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista con SP1 [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | processthreadsapi.h (includere Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2) |
Libreria | Kernel32.lib |
DLL | Kernel32.dll |