GetProcessGroupAffinity-Funktion (processtopologyapi.h)

  • Artikel

Ruft die Prozessorgruppenaffinität des angegebenen Prozesses ab.

Syntax

BOOL GetProcessGroupAffinity(
  [in]      HANDLE  hProcess,
  [in, out] PUSHORT GroupCount,
  [out]     PUSHORT GroupArray
);

Parameter

[in] hProcess

Ein Handle für den Prozess.

Dieses Handle muss über das PROCESS_QUERY_INFORMATION- oder PROCESS_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

[in, out] GroupCount

Gibt bei der Eingabe die Anzahl der Elemente im GroupArray-Array an. Gibt bei der Ausgabe die Anzahl der Prozessorgruppen an, die in das Array geschrieben werden. Wenn das Array zu klein ist, schlägt die Funktion mit ERROR_INSUFFICIENT_BUFFER fehl und legt den GroupCount-Parameter auf die Anzahl der erforderlichen Elemente fest.

[out] GroupArray

Ein Array von Prozessorgruppennummern. Eine Gruppennummer ist im Array enthalten, wenn einem Prozessor in der Gruppe ein Thread im Prozess zugewiesen ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie GetLastError, um erweiterte Fehlerinformationen abzurufen.

Wenn der Fehlerwert ERROR_INSUFFICIENT_BUFFER ist, enthält der GroupCount-Parameter die erforderliche Puffergröße in Anzahl der Elemente.

Hinweise

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.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile processtopologyapi.h (Einschließen von Windows.h unter Windows Server 2008 Windows Server 2008 R2)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

GetThreadGroupAffinity

Prozessorgruppen