---
name: "SetThreadIdealProcessor"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/SetThreadIdealProcessor"
---

# SetThreadIdealProcessor(3w)

## NAME

**SetThreadIdealProcessor** (KERNEL32.@)

## SYNOPSIS

DWORD SetThreadIdealProcessor\
  (\
   HANDLE *hThread*,\
   DWORD  *dwIdealProcessor*\
  )

## PARAMS

*hThread* **\[In\]**  Specifies the thread of interest.

*dwIdealProcessor* **\[In\]**  Specifies the new preferred processor.

## DESCRIPTION

SetThreadIdealProcessor \[**KERNEL32**.@\] Sets preferred processor for thread.

## RETURNS

**Success:** Value of last call to SetThreadIdealProcessor

**Failure:** **-1**

## IMPLEMENTATION

Declared in **"winbase.h"**.

Implemented in **"dlls/kernel32/thread.c"**.

Debug channel **"thread"**.
