GetProcessGroupAffinity-Funktion (processtopologyapi.h)
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 |