SetXStateFeaturesMask-Funktion (winbase.h)
Legt die Maske der XState-Features fest, die innerhalb einer Struktur CONTEXT festgelegt sind.
Syntax
BOOL SetXStateFeaturesMask(
[in, out] PCONTEXT Context,
[in] DWORD64 FeatureMask
);
Parameter
[in, out] Context
Ein Zeiger auf eine CONTEXT-Struktur , die mit InitializeContext initialisiert wurde.
[in] FeatureMask
Eine Maske von XState-Features, die in der angegebenen CONTEXT-Struktur festgelegt werden sollen.
Rückgabewert
Diese Funktion gibt bei erfolgreicher Ausführung TRUE zurück, andernfalls FALSE.
Hinweise
Die SetXStateFeaturesMask-Funktion legt die Maske der gültigen Features im angegebenen Kontext fest. Vor dem Aufrufen von GetThreadContext, Wow64GetThreadContext, SetThreadContext oder Wow64SetThreadContext muss die Anwendung SetXStateFeaturesMask aufrufen, um anzugeben, welche Features abgerufen oder festgelegt werden sollen. Das System ignoriert im Hintergrund alle in der FeatureMask angegebenen Features, die für den Prozessor nicht aktiviert sind.
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 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |