GetXStateFeaturesMask-Funktion (winbase.h)

Artikel
03/03/2024

Gibt die Maske der XState-Features zurück, die innerhalb einer Struktur CONTEXT festgelegt sind.

Syntax

BOOL GetXStateFeaturesMask(
  [in]  PCONTEXT Context,
  [out] PDWORD64 FeatureMask
);

Parameter

[in] Context

Ein Zeiger auf eine CONTEXT-Struktur , die mit InitializeContext initialisiert wurde.

[out] FeatureMask

Ein Zeiger auf eine Variable, die die Maske der XState-Features empfängt, die in der angegebenen CONTEXT-Struktur vorhanden sind.

Rückgabewert

Diese Funktion gibt bei erfolgreicher Ausführung TRUE zurück, andernfalls FALSE.

Hinweise

Die GetXStateFeaturesMask-Funktion gibt die Maske der gültigen Features im angegebenen Kontext zurück. Wenn ein CONTEXT an GetThreadContext oder Wow64GetThreadContext übergeben werden soll, muss die Anwendung SetXStateFeaturesMask aufrufen, um festzulegen, welche Features abgerufen werden sollen. GetXStateFeaturesMask sollte dann für den von GetThreadContext oder Wow64GetThreadContext zurückgegebenen CONTEXT aufgerufen werden, um zu bestimmen, welche Featurebereiche gültige Daten enthalten. Wenn ein bestimmtes Featurebit nicht festgelegt ist, befindet sich der entsprechende Zustand in einem prozessorspezifischen INITIALIZED-Zustand , und der Inhalt des von LocateXStateFeature abgerufenen Featurebereichs ist nicht definiert.

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

Hinweis Der wert, der von GetXStateFeaturesMask in einem CONTEXT nach einem Kontextvorgang zurückgegeben wird, ist immer eine Teilmenge der Maske, die in einem Aufruf von SetXStateFeaturesMask vor dem Kontextvorgang angegeben wurde.

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

Anforderung	Wert
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