Função SetThreadIdealProcessorEx (processthreadsapi.h)
Define o processador ideal para o thread especificado e, opcionalmente, recupera o processador ideal anterior.
Sintaxe
BOOL SetThreadIdealProcessorEx(
[in] HANDLE hThread,
[in] PPROCESSOR_NUMBER lpIdealProcessor,
[out, optional] PPROCESSOR_NUMBER lpPreviousIdealProcessor
);
Parâmetros
[in] hThread
Um identificador para o thread para o qual definir o processador ideal. Esse identificador deve ter sido criado com o direito de acesso THREAD_SET_INFORMATION. Para obter mais informações, consulte Segurança de thread e direitos de acesso.
[in] lpIdealProcessor
Um ponteiro para uma estrutura PROCESSOR_NUMBER que especifica o número do processador do processador ideal desejado.
[out, optional] lpPreviousIdealProcessor
Um ponteiro para uma estrutura PROCESSOR_NUMBER para receber o processador ideal anterior. Esse parâmetro pode apontar para o mesmo local de memória que o parâmetro lpIdealProcessor . Esse parâmetro poderá ser NULL se o processador ideal anterior não for necessário.
Retornar valor
Se a função for bem-sucedida, ela retornará um valor diferente de zero.
Se a função falhar, ela retornará zero. Para obter informações de erro estendidas, use GetLastError.
Comentários
Especificar um processador ideal de thread fornece uma dica ao agendador sobre o processador preferencial para um thread. O agendador executa o thread no processador ideal do thread quando possível.
A partir do Windows 11 e do Windows Server 2022, em um sistema com mais de 64 processadores, afinidades de processo e thread abrangem todos os processadores no sistema, em todos os grupos de processadores, por padrão. O SetThreadIdealProcessorEx, ao definir o processador preferencial, também define o grupo primário do thread como o grupo do processador preferencial.
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT >= 0x0601. Para obter mais informações, consulte Usando os cabeçalhos do Windows.
Windows Phone 8.1: essa função tem suporte para aplicativos Windows Phone Store no Windows Phone 8.1 e posterior.
Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | processthreadsapi.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib; WindowsPhoneCore.lib no Windows Phone 8.1 |
| DLL | Kernel32.dll; KernelBase.dll no Windows Phone 8.1 |