Fungsi SetXStateFeaturesMask (winbase.h)

Artikel
03/09/2024

Mengatur topeng fitur XState yang diatur dalam struktur CONTEXT .

Sintaks

BOOL SetXStateFeaturesMask(
  [in, out] PCONTEXT Context,
  [in]      DWORD64  FeatureMask
);

Parameter

[in, out] Context

Penunjuk ke struktur CONTEXT yang telah diinisialisasi dengan InitializeContext.

[in] FeatureMask

Masker fitur XState untuk diatur dalam struktur CONTEXT yang ditentukan.

Nilai kembali

Fungsi ini mengembalikan TRUE jika berhasil, jika tidak FALSE.

Keterangan

Fungsi SetXStateFeaturesMask mengatur topeng fitur yang valid dalam konteks yang ditentukan. Sebelum memanggil GetThreadContext, Wow64GetThreadContext, SetThreadContext, atau Wow64SetThreadContext , aplikasi harus memanggil SetXStateFeaturesMask untuk menentukan kumpulan fitur mana yang akan diambil atau diatur. Sistem secara diam-diam mengabaikan fitur apa pun yang ditentukan dalam FeatureMask yang tidak diaktifkan pada prosesor.

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 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll