GetEnabledXStateFeatures-Funktion (winbase.h)

  • Artikel

Ruft eine Maske aktivierter XState-Features auf x86- oder x64-Prozessoren ab.

Die Definition von XState-Featurebits ist prozessorherstellerspezifisch. Weitere Informationen zu einem bestimmten Feature finden Sie in den relevanten Referenzhandbüchern des Prozessors.

Syntax

DWORD64 GetEnabledXStateFeatures();

Rückgabewert

Diese Funktion gibt eine Bitmaske zurück, in der jedes Bit ein XState-Feature darstellt, das auf dem System aktiviert ist.

Hinweise

Eine Anwendung sollte diese Funktion aufrufen, um zu ermitteln, welche Features auf dem System vorhanden und aktiviert sind, bevor sie ein XState-Prozessorfeature verwendet oder versucht, XState-Kontexte zu bearbeiten. Bits 0 und 1 beziehen sich auf die X87-FPU bzw. das Vorhandensein von SSE-Registern. Die Bedeutungen bestimmter Featurebits, die über 0 und 1 hinausgehen, werden in den Programmer-Referenzhandbüchern definiert, die von den Prozessoranbietern veröffentlicht werden.

Hinweis Möglicherweise sind nicht alle von einem Prozessor unterstützten Features auf dem System aktiviert. Die Verwendung eines features, das nicht aktiviert ist, kann zu Ausnahmen oder nicht definiertem Verhalten führen.

 

Windows 7 mit SP1 und Windows Server 2008 R2 mit SP1: Die AVX-API wird zuerst unter Windows 7 mit SP1 und Windows Server 2008 R2 mit SP1 implementiert. Da es kein SDK für SP1 gibt, bedeutet dies, dass keine Header und Bibliotheksdateien verfügbar sind, mit denen Sie arbeiten können. In dieser Situation muss ein Aufrufer die erforderlichen Funktionen aus dieser Dokumentation deklarieren und Zeiger darauf mithilfe von GetModuleHandle auf „Kernel32.dll“ gefolgt von Aufrufen von GetProcAddress abrufen. Weitere Informationen finden Sie unter Arbeiten mit dem XState-Kontext .

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 mit SP1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 mit SP1 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winbase.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Intel AVX

Arbeiten mit XState-Kontext