Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Restituisce la maschera delle funzionalità XState impostate all'interno di una struttura CONTEXT .
Sintassi
BOOL GetXStateFeaturesMask(
[in] PCONTEXT Context,
[out] PDWORD64 FeatureMask
);
Parameters
[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.
Osservazioni:
La funzione GetXStateFeaturesMask restituisce la maschera delle funzionalità valide nel contesto specificato. Se un context deve essere passato a GetThreadContext o Wow64GetThreadContext, l'applicazione deve chiamare SetXStateFeaturesMask per impostare le funzionalità da recuperare. GetXStateFeaturesMask deve quindi essere chiamato sul CONTESTO restituito da GetThreadContext o Wow64GetThreadContext per determinare quali aree di funzionalità contengono dati validi. Se non è impostato un bit di funzionalità specifico, lo stato corrispondente è in uno stato INITIALIZED specifico del processore e il contenuto dell'area di funzionalità recuperata da LocateXStateFeature non è definito.
La definizione delle funzionalità XState è specifica del fornitore del processore. Per altre informazioni su una particolare funzionalità, vedere i manuali di riferimento del processore pertinenti.
Nota Il valore restituito da GetXStateFeaturesMask in 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 implementata per la prima volta 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 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 | Value |
|---|---|
| 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 (includere Windows.h) |
| Raccolta | Kernel32.lib |
| DLL | Kernel32.dll |