Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gibt die Maske der XState-Features zurück, die in einer CONTEXT-Struktur 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 WAHR zurück, wenn die Funktion erfolgreich verläuft, andernfalls FALSE.
Bemerkungen
Die GetXStateFeaturesMask-Funktion gibt die Maske gültiger 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 kontext aufgerufen werden, der von GetThreadContext oder Wow64GetThreadContext zurückgegeben wird, um zu bestimmen, welche Featurebereiche gültige Daten enthalten. Wenn kein bestimmtes Featurebit festgelegt ist, befindet sich der entsprechende Zustand in einem prozessorspezifischen INITIALISIERTEN Zustand, und der Inhalt des von LocateXStateFeature abgerufenen Featurebereichs ist nicht definiert.
Die Definition der XState-Features ist prozessorspezifischer Anbieter. Weitere Informationen zu einem bestimmten Feature finden Sie in den entsprechenden Prozessorreferenzhandbüchern.
Hinweis Der von GetXStateFeaturesMask in einem KONTEXT zurückgegebene Wert nach einem Kontextvorgang ist immer eine Teilmenge des in einem Aufruf von SetXStateFeaturesMask angegebenen Masken vor dem Kontextvorgang.
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 es keine verfügbaren Header- und Bibliotheksdateien gibt, mit denen sie arbeiten können. In diesem Fall muss ein Aufrufer die erforderlichen Funktionen aus dieser Dokumentation deklarieren und Zeiger mithilfe von "GetModuleHandle " auf "Kernel32.dll" abrufen, gefolgt von Aufrufen von GetProcAddress. Ausführliche Informationen finden Sie unter "Arbeiten mit XState-Kontext ".
Requirements
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows 7 mit SP1 [Desktop-Apps | UWP-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2008 R2 mit SP1 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Header | winbase.h (enthalten Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |