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

Confira também

GetThreadIdealProcessorEx

SetThreadIdealProcessor