Funzione SetThreadIdealProcessorEx (processthreadsapi.h)

  • Articolo

Imposta il processore ideale per il thread specificato e, facoltativamente, recupera il processore ideale precedente.

Sintassi

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

Parametri

[in] hThread

Handle per il thread per il quale impostare il processore ideale. Questo handle deve essere stato creato con il diritto di accesso THREAD_SET_INFORMATION. Per altre informazioni, vedere Thread Security and Access Rights.For more information, see Thread Security and Access Rights.

[in] lpIdealProcessor

Puntatore a una struttura PROCESSOR_NUMBER che specifica il numero di processore del processore ideale desiderato.

[out, optional] lpPreviousIdealProcessor

Puntatore a una struttura PROCESSOR_NUMBER per ricevere il processore ideale precedente. Questo parametro può puntare alla stessa posizione di memoria del parametro lpIdealProcessor . Questo parametro può essere NULL se il processore ideale precedente non è necessario.

Valore restituito

Se la funzione ha esito positivo, restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero. Per ottenere informazioni estese sull'errore, usare GetLastError.

Commenti

Specificando un processore ideale di thread, viene fornito un suggerimento all'utilità di pianificazione sul processore preferito per un thread. L'utilità di pianificazione esegue il thread nel processore ideale del thread, quando possibile.

A partire da Windows 11 e Windows Server 2022, in un sistema con più di 64 processori, affinità tra processi e thread si estendono su tutti i processori nel sistema, in tutti i gruppi di processori, per impostazione predefinita. SetThreadIdealProcessorEx, nell'impostazione del processore preferito, imposta anche il gruppo primario del thread sul gruppo del processore preferito.

Per compilare un'applicazione che usa questa funzione, impostare _WIN32_WINNT = 0x0601 >. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Windows Phone 8.1: questa funzione è supportata per Windows Phone app dello Store in Windows Phone 8.1 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione processthreadsapi.h (include Windows.h)
Libreria Kernel32.lib; WindowsPhoneCore.lib in Windows Phone 8.1
DLL Kernel32.dll; KernelBase.dll Windows Phone 8.1

Vedi anche

GetThreadIdealProcessorEx

SetThreadIdealProcessor