Edit

GetThreadIdealProcessorEx function (processthreadsapi.h)

  • Article

Retrieves the processor number of the ideal processor for the specified thread.

Syntax

BOOL GetThreadIdealProcessorEx(
  [in]  HANDLE            hThread,
  [out] PPROCESSOR_NUMBER lpIdealProcessor
);

Parameters

[in] hThread

A handle to the thread for which to retrieve the ideal processor. This handle must have been created with the THREAD_QUERY_LIMITED_INFORMATION access right. For more information, see Thread Security and Access Rights.

[out] lpIdealProcessor

Points to PROCESSOR_NUMBER structure to receive the number of the ideal processor.

Return value

If the function succeeds, it returns a nonzero value.

If the function fails, it returns zero. To get extended error information, use GetLastError.

Remarks

To compile an application that uses this function, set _WIN32_WINNT >= 0x0601. For more information, see Using the Windows Headers.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header processthreadsapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See also

SetThreadIdealProcessorEx