SetThreadIdealProcessorEx-Funktion (processthreadsapi.h)

  • Artikel

Legt den idealen Prozessor für den angegebenen Thread fest und ruft optional den vorherigen idealen Prozessor ab.

Syntax

BOOL SetThreadIdealProcessorEx(
  [in]            HANDLE            hThread,
  [in]            PPROCESSOR_NUMBER lpIdealProcessor,
  [out, optional] PPROCESSOR_NUMBER lpPreviousIdealProcessor
);

Parameter

[in] hThread

Ein Handle für den Thread, für den der ideale Prozessor festgelegt werden soll. Dieses Handle muss mit dem zugriffsrecht THREAD_SET_INFORMATION erstellt worden sein. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.

[in] lpIdealProcessor

Ein Zeiger auf eine PROCESSOR_NUMBER-Struktur , die die Prozessornummer des gewünschten idealen Prozessors angibt.

[out, optional] lpPreviousIdealProcessor

Ein Zeiger auf eine PROCESSOR_NUMBER Struktur, um den vorherigen idealen Prozessor zu empfangen. Dieser Parameter kann auf denselben Speicherspeicherort wie der lpIdealProcessor-Parameter verweisen. Dieser Parameter kann NULL sein, wenn der vorherige ideale Prozessor nicht erforderlich ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie einen Wert ohne Zero zurück.

Wenn die Funktion fehlschlägt, gibt sie null zurück. Verwenden Sie GetLastError, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Die Angabe eines idealen Threadprozessors gibt dem Planer einen Hinweis auf den bevorzugten Prozessor für einen Thread. Der Planer führt den Thread nach Möglichkeit auf dem idealen Prozessor des Threads aus.

Ab Windows 11 und Windows Server 2022 umfassen auf einem System mit mehr als 64 Prozessoren standardmäßig Prozess- und Threadaffinitäten alle Prozessoren im System, und das über alle Prozessorgruppen hinweg. SetThreadIdealProcessorEx legt beim Festlegen des bevorzugten Prozessors auch die primäre Gruppe des Threads auf die Gruppe des bevorzugten Prozessors fest.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, legen Sie _WIN32_WINNT >= 0x0601 fest. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Windows Phone 8.1: Diese Funktion wird für Windows Phone Store-Apps unter Windows Phone 8.1 und höher unterstützt.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile processthreadsapi.h (einschließlich Windows.h)
Bibliothek Kernel32.lib; WindowsPhoneCore.lib unter Windows Phone 8.1
DLL Kernel32.dll; KernelBase.dll am Windows Phone 8.1

Weitere Informationen

GetThreadIdealProcessorEx

SetThreadIdealProcessor