SetXStateFeaturesMask-Funktion (winbase.h)

Artikel
03/03/2024

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