GetXStateFeaturesMask 関数 (winbase.h)
CONTEXT 構造体内に設定された XState 機能のマスクを返します。
構文
BOOL GetXStateFeaturesMask(
[in] PCONTEXT Context,
[out] PDWORD64 FeatureMask
);
パラメーター
[in] Context
InitializeContext で初期化された CONTEXT 構造体へのポインター。
[out] FeatureMask
指定した CONTEXT 構造体に存在する XState 特徴のマスクを受け取る変数へのポインター。
戻り値
この関数は、成功した場合 は TRUE を返し、それ以外の場合は FALSE を返します。
注釈
GetXStateFeaturesMask 関数は、指定されたコンテキストで有効な機能のマスクを返します。 CONTEXT を GetThreadContext または Wow64GetThreadContext に渡す場合、アプリケーションは SetXStateFeaturesMask を呼び出して、取得する機能を設定する必要があります。 GetXStateFeaturesMask は、GetThreadContext または Wow64GetThreadContext によって返される CONTEXT で呼び出して、有効なデータを含む機能領域を決定する必要があります。 特定の機能ビットが設定されていない場合、対応する状態はプロセッサ固有の INITIALIZED 状態であり、 LocateXStateFeature によって取得された機能領域の内容は未定義です。
XState 機能の定義は、プロセッサ ベンダー固有です。 特定の機能に関する追加情報については、関連するプロセッサリファレンスマニュアルを参照してください。
Windows 7 SP1 と Windows Server 2008 R2 SP1: AVX API は、WINDOWS 7 SP1 と Windows Server 2008 R2 SP1 で最初に実装されます。 SP1 用の SDK がないため、使用できるヘッダーとライブラリ ファイルはありません。 このような場合、呼び出し元は、このドキュメントから必要な関数を宣言し、"Kernel32.dll" で GetModuleHandle を使用してポインターを取得し、続いて GetProcAddress を呼び出す必要があります。 詳細については、「 XState コンテキストの操作 」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | WINDOWS 7 SP1 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 SP1 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |