次の方法で共有


GetXStateFeaturesMask 関数 (winbase.h)

CONTEXT 構造体内に設定された XState 機能のマスクを返します。

構文

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

パラメーター

[in] Context

InitializeContext で初期化された CONTEXT 構造体へのポインター。

[out] FeatureMask

指定した CONTEXT 構造体に存在する XState 特徴のマスクを受け取る変数へのポインター。

戻り値

この関数は、成功した場合 は TRUE を返し、それ以外の場合は FALSE を返します

注釈

GetXStateFeaturesMask 関数は、指定されたコンテキストで有効な機能のマスクを返します。 CONTEXTGetThreadContext または Wow64GetThreadContext に渡す場合、アプリケーションは SetXStateFeaturesMask を呼び出して、取得する機能を設定する必要があります。 GetXStateFeaturesMask は、GetThreadContext または Wow64GetThreadContext によって返される CONTEXT で呼び出して、有効なデータを含む機能領域を決定する必要があります。 特定の機能ビットが設定されていない場合、対応する状態はプロセッサ固有の INITIALIZED 状態であり、 LocateXStateFeature によって取得された機能領域の内容は未定義です。

XState 機能の定義は、プロセッサ ベンダー固有です。 特定の機能に関する追加情報については、関連するプロセッサリファレンスマニュアルを参照してください。

メモコンテキスト操作の後に CONTEXTGetXStateFeaturesMask によって返される値は、コンテキスト操作の前に SetXStateFeaturesMask の呼び出しで指定されたマスクのサブセットになります。
 

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

関連項目

CONTEXT

GetThreadContext

Intel AVX

SetXStateFeaturesMask

XState コンテキストの操作

Wow64GetThreadContext