Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ProcessThread::IdealProcessor Property

 

Sets the preferred processor for this thread to run on.

Namespace:   System.Diagnostics
Assembly:  System (in System.dll)

public:
[BrowsableAttribute(false)]
property int IdealProcessor {
	void set(int value);
}

Property Value

Type: System::Int32

The preferred processor for the thread, used when the system schedules threads, to determine which processor to run the thread on.

Exception Condition
Win32Exception

The system could not set the thread to start on the specified processor.

PlatformNotSupportedException

The platform is Windows 98 or Windows Millennium Edition.

NotSupportedException

The process is on a remote computer.

The IdealProcessor value is zero-based. In other words, to set the thread affinity for the first processor, set the property to zero.

The system schedules threads on their preferred processors whenever possible.

A process thread can migrate from processor to processor, with each migration reloading the processor cache. Specifying a processor for a thread can improve performance under heavy system loads by reducing the number of times the processor cache is reloaded.

The following example demonstrates how to set the IdealProcessor property for an instance of Notepad to the first processor.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show:
© 2017 Microsoft