EnableProcessOptionalXStateFeatures-Funktion (winbase.h)

Diese Funktion ermöglicht eine Reihe optionaler XState-Features für den aktuellen Prozess.

Syntax

BOOL EnableProcessOptionalXStateFeatures(
  DWORD64 Features
);

Parameter

Features

Eine Bitmaske, in der jedes Bit ein optionales XState-Feature darstellt, das für den aktuellen Prozess aktiviert werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Im Allgemeinen sind optionale XState-Features für neu erstellte Threads standardmäßig deaktiviert und später bei Bedarf aktiviert. Wenn diese Funktion zurückgibt, werden die angegebenen optionalen XState-Features für alle vorhandenen Threads im aktuellen Prozess aktiviert, und für alle zukünftigen Threads, die im Prozess erstellt werden, werden die angegebenen optionalen XState-Features zum Zeitpunkt der Threaderstellung aktiviert.

Nur vom System unterstützte XState-Featurebits dürfen für diese Funktion bereitgestellt werden, andernfalls wird ein Fehler zurückgegeben. Die vom System unterstützten XState-Featurebits können über die GetEnabledXStateFeatures-Routine abgerufen werden. Wenn nicht optionale vom System unterstützte XState-Featurebits bereitgestellt werden (z. B. AVX, AVX2 usw. sind nicht optionale XState-Features), werden diese ignoriert und führen nicht dazu, dass diese Funktion einen Fehler zurückgibt. Beachten Sie, dass alle nicht optionalen XState-Features, die vom System unterstützt werden, standardmäßig für jeden Thread aktiviert sind.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 11
Unterstützte Mindestversion (Server)	Windows Server 2022
Kopfzeile	winbase.h

Weitere Informationen

GetEnabledXStateFeatures

GetThreadEnabledXStateFeatures