Fungsi LocateXStateFeature (winbase.h)

Artikel
03/08/2023

Mengambil penunjuk ke status prosesor untuk fitur XState dalam struktur CONTEXT .

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

Sintaks

PVOID LocateXStateFeature(
  [in]            PCONTEXT Context,
  [in]            DWORD    FeatureId,
  [out, optional] PDWORD   Length
);

Parameter

[in] Context

Penunjuk ke struktur CONTEXT yang berisi status untuk diambil atau diatur. CONTEXT ini seharusnya diinisialisasi dengan InitializeContext dengan bendera CONTEXT_XSTATE yang diatur dalam parameter ContextFlags.

[in] FeatureId

Jumlah fitur yang akan ditemukan dalam struktur CONTEXT .

[out, optional] Length

Penunjuk ke variabel yang menerima panjang area fitur dalam byte. Isi variabel ini tidak terdefinisi jika fungsi ini mengembalikan NULL.

Nilai kembali

Jika fitur yang ditentukan didukung oleh sistem dan struktur CONTEXT yang ditentukan telah diinisialisasi dengan bendera CONTEXT_XSTATE , fungsi ini mengembalikan penunjuk ke area fitur untuk fitur yang ditentukan. Isi dan tata letak area ini khusus prosesor.

Jika bendera CONTEXT_XSTATE tidak diatur dalam struktur CONTEXT atau FeatureID tidak didukung oleh sistem, nilai yang dikembalikan adalah NULL. Tidak ada informasi kesalahan tambahan yang tersedia.

Keterangan

Fungsi LocateXStateFeature harus digunakan untuk menemukan fitur XState individual dalam struktur CONTEXT yang dapat diperluas. Fitur belum tentu berdekatan dalam memori dan aplikasi tidak boleh mengasumsikan offset antara dua fitur berturut-turut akan tetap konstan di masa depan.

Parameter FeatureID fungsi sesuai dengan sedikit dalam masker fitur. Misalnya, FeatureId 2 sesuai dengan FeatureMask 4 di SetXStateFeaturesMask. Nilai FeatureID 0 dan 1 masing-masing sesuai dengan status FPU X87 dan status SSE.

Jika Anda mengatur XState pada utas melalui API SetThreadContext atau Wow64SetThreadContext , Anda juga harus memanggil SetXStateFeaturesMask pada struktur CONTEXT dengan nilai mask fitur yang diisi untuk menandai fitur sebagai aktif.

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