EnableProcessOptionalXStateFeatures-Funktion (winbase.h)

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

Syntax

BOOL EnableProcessOptionalXStateFeatures(
  DWORD64 Features
);

Die Parameter

Features

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

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

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

Für diese Funktion dürfen nur XState-Featurebits bereitgestellt werden, die vom System unterstützt 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 XState-Featurebits bereitgestellt werden, die vom System unterstützt werden (z. B. AVX, AVX2 usw. 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

Siehe auch

GetEnabledXStateFeatures

GetThreadEnabledXStateFeatures