Fungsi GetXStateFeaturesMask (winbase.h)

Artikel
08/27/2023

Mengembalikan masker fitur XState yang diatur dalam struktur CONTEXT .

Sintaks

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

Parameter

[in] Context

Penunjuk ke struktur CONTEXT yang telah diinisialisasi dengan InitializeContext.

[out] FeatureMask

Penunjuk ke variabel yang menerima masker fitur XState yang ada dalam struktur CONTEXT yang ditentukan.

Nilai kembali

Fungsi ini mengembalikan TRUE jika berhasil, jika tidak FALSE.

Keterangan

Fungsi GetXStateFeaturesMask mengembalikan mask fitur yang valid dalam konteks yang ditentukan. Jika CONTEXT akan diteruskan ke GetThreadContext atau Wow64GetThreadContext, aplikasi harus memanggil SetXStateFeaturesMask untuk mengatur fitur mana yang akan diambil. GetXStateFeaturesMask kemudian harus dipanggil pada CONTEXT yang dikembalikan oleh GetThreadContext atau Wow64GetThreadContext untuk menentukan area fitur mana yang berisi data yang valid. Jika bit fitur tertentu tidak diatur, status yang sesuai berada dalam status INITIALIZED khusus prosesor dan konten area fitur yang diambil oleh LocateXStateFeature tidak terdefinisi.

Definisi fitur XState adalah vendor prosesor khusus. Silakan lihat manual referensi prosesor yang relevan untuk informasi tambahan tentang fitur tertentu.

Catatan Nilai yang dikembalikan oleh GetXStateFeaturesMask pada CONTEXT setelah operasi konteks akan selalu menjadi subset masker yang ditentukan dalam panggilan ke SetXStateFeaturesMask sebelum operasi konteks.

Windows 7 dengan SP1 dan Windows Server 2008 R2 dengan SP1: API AVX pertama kali diimplementasikan pada Windows 7 dengan SP1 dan Windows Server 2008 R2 dengan SP1 . Karena tidak ada SDK untuk SP1, itu berarti tidak ada header dan file pustaka yang tersedia untuk dikerjakan. Dalam situasi ini, penelepon harus mendeklarasikan fungsi yang diperlukan dari dokumentasi ini dan mendapatkan pointer kepada mereka menggunakan GetModuleHandle pada "Kernel32.dll", diikuti dengan panggilan ke GetProcAddress. Lihat Bekerja dengan Konteks XState untuk detailnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 dengan SP1 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 dengan SP1 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll