GetPerformanceInfo-Funktion (psapi.h)
Ruft die Leistungswerte ab, die in der PERFORMANCE_INFORMATION-Struktur enthalten sind.
Syntax
BOOL GetPerformanceInfo(
[out] PPERFORMANCE_INFORMATION pPerformanceInformation,
[in] DWORD cb
);
Parameter
[out] pPerformanceInformation
Ein Zeiger auf eine PERFORMANCE_INFORMATION-Struktur , die die Leistungsinformationen empfängt.
[in] cb
Die Größe der PERFORMANCE_INFORMATION-Struktur in Bytes.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE. Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Ab Windows 7 und Windows Server 2008 R2 richtet Psapi.h Versionsnummern für die PSAPI-Funktionen ein. Die PSAPI-Versionsnummer wirkt sich auf den Namen aus, der zum Aufrufen der Funktion und der Bibliothek verwendet wird, die ein Programm laden muss.
Wenn PSAPI_VERSION 2 oder höher ist, wird diese Funktion als K32GetPerformanceInfo in Psapi.h definiert und in Kernel32.lib und Kernel32.dll exportiert. Wenn PSAPI_VERSION 1 ist, wird diese Funktion als GetPerformanceInfo in Psapi.h definiert und in Psapi.lib und Psapi.dll als Wrapper exportiert, der K32GetPerformanceInfo aufruft.
Programme, die unter früheren Versionen von Windows sowie Windows 7 und höheren Versionen ausgeführt werden müssen, sollten diese Funktion immer als GetPerformanceInfo aufrufen. Fügen Sie dem TARGETLIBS-Makro Psapi.lib hinzu, und kompilieren Sie das Programm mit –DPSAPI_VERSION=1, um die richtige Auflösung von Symbolen sicherzustellen. Laden Sie Psapi.dll, um dynamische Laufzeitverknüpfung zu verwenden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | psapi.h |
| Bibliothek | Kernel32.lib unter Windows 7 und Windows Server 2008 R2; Psapi.lib (wenn PSAPI_VERSION=1) unter Windows 7 und Windows Server 2008 R2; Psapi.lib unter Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP |
| DLL | Kernel32.dll unter Windows 7 und Windows Server 2008 R2; Psapi.dll (wenn PSAPI_VERSION=1) unter Windows 7 und Windows Server 2008 R2; Psapi.dll unter Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP |