Funzione GetXStateFeaturesMask (winbase.h)

Articolo
03/13/2024

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

Sintassi

BOOL GetXStateFeaturesMask(
  [in]  PCONTEXT Context,
  [out] PDWORD64 FeatureMask
);

Parametri

[in] Context

Puntatore a una struttura CONTEXT inizializzata con InitializeContext.

[out] FeatureMask

Puntatore a una variabile che riceve la maschera delle funzionalità XState presenti nella struttura CONTEXT specificata.

Valore restituito

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

Commenti

La funzione GetXStateFeaturesMask restituisce la maschera di funzionalità valide nel contesto specificato. Se un CONTESTO deve essere passato a GetThreadContext o Wow64GetThreadContext, l'applicazione deve chiamare SetXStateFeaturesMask per impostare le funzionalità da recuperare. GetXStateFeaturesMask deve quindi essere chiamato nel CONTESTO restituito da GetThreadContext o Wow64GetThreadContext per determinare quali aree di funzionalità contengono dati validi. Se un bit di funzionalità specifico non è impostato, lo stato corrispondente si trova in uno stato INIZIALIZZATO specifico del processore e il contenuto dell'area di funzionalità recuperata da LocateXStateFeature non sono definiti.

La definizione delle funzionalità XState è specifica del fornitore del processore. Per altre informazioni su una determinata funzionalità, vedere i manuali di riferimento relativi al processore pertinente.

Nota Il valore restituito da GetXStateFeaturesMaskin un CONTESTO dopo un'operazione di contesto sarà sempre un subset della maschera specificata in una chiamata a SetXStateFeaturesMask prima dell'operazione di contesto.

Windows 7 con SP1 e Windows Server 2008 R2 con SP1: L'API AVX viene prima implementata in Windows 7 con SP1 e Windows Server 2008 R2 con SP1 . Poiché non è disponibile SDK per SP1, significa che non sono disponibili intestazioni e file di libreria da usare. In questa situazione, un chiamante deve dichiarare le funzioni necessarie da questa documentazione e ottenere puntatori a loro 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 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 con SP1 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll