Funzione SetXStateFeaturesMask (winbase.h)

Articolo
03/03/2024

Imposta la maschera delle funzionalità XState impostate all'interno di una struttura CONTEXT .

Sintassi

BOOL SetXStateFeaturesMask(
  [in, out] PCONTEXT Context,
  [in]      DWORD64  FeatureMask
);

Parametri

[in, out] Context

Puntatore a una struttura CONTEXT inizializzata con InitializeContext.

[in] FeatureMask

Maschera delle funzionalità XState da impostare nella struttura CONTEXT specificata.

Valore restituito

Questa funzione restituisce TRUE se ha esito positivo; in caso contrario , FALSE.

Commenti

La funzione SetXStateFeaturesMask imposta la maschera delle funzionalità valide nel contesto specificato. Prima di chiamare GetThreadContext, Wow64GetThreadContext, SetThreadContext o Wow64SetThreadContext , l'applicazione deve chiamare SetXStateFeaturesMask per specificare il set di funzionalità da recuperare o impostare. Il sistema ignora automaticamente qualsiasi funzionalità specificata in FeatureMask che non è abilitata nel processore.

Windows 7 con SP1 e Windows Server 2008 R2 con SP1: L'API AVX viene implementata per la prima volta in Windows 7 con SP1 e Windows Server 2008 R2 con SP1 . Poiché non esiste alcun SDK per SP1, significa che non sono disponibili intestazioni e file di libreria da usare. In questo caso, un chiamante deve dichiarare le funzioni necessarie da questa documentazione e ottenere i puntatori usando GetModuleHandle in "Kernel32.dll", seguito dalle chiamate a GetProcAddress. Per informazioni dettagliate , vedere Uso del contesto XState .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll