GetXStateFeaturesMask 関数 (winbase.h)

CONTEXT 構造体内で設定された XState フィーチャのマスクを返します。

構文

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

Parameters

[in] Context

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

[out] FeatureMask

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

戻り値

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

注釈

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

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

メモコンテキスト操作の後に CONTEXT の GetXStateFeaturesMask によって返される値は、コンテキスト操作の前に 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 コンテキストの操作を参照してください。

Requirements

Requirement	価値
サポートされる最小クライアント	SP1 を使用したWindows 7 [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2 sp1 [デスクトップアプリ \|UWP アプリ]
ターゲットプラットフォームの	Windows
ヘッダー	winbase.h (Windows.h を含む)
ライブラリ	Kernel32.lib
DLL	Kernel32.dll