WHvSetVirtualProcessorInterruptControllerState2

Mengatur status APIC lokal prosesor virtual.

Important

WHvSetVirtualProcessorInterruptControllerState2 tidak digunakan lagi. Gunakan WHvSetVirtualProcessorState dengan jenis status sebagai gantinya WHvVirtualProcessorStateTypeInterruptControllerState2 .

Note

Fungsi ini hanya berlaku untuk partisi x64.

Syntax

HRESULT
WINAPI
WHvSetVirtualProcessorInterruptControllerState2(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT32 VpIndex,
    _In_reads_bytes_(StateSize) const VOID* State,
    _In_ UINT32 StateSize
    );

Parameters

Partition

Tangani ke objek partisi.

VpIndex

Menentukan indeks prosesor virtual yang status pengontrol interupsinya diatur.

State

Menentukan status pengontrol interupsi yang akan diterapkan, dalam format status eksternal standar.

StateSize

Menentukan ukuran State, dalam byte.

Mengembalikan Nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah S_OK.

Jika State adalah NULL, atau jika StateSize lebih kecil dari ukuran status yang diperlukan, nilai yang dikembalikan adalah E_POINTER. Jika VpIndex tidak mengidentifikasi prosesor virtual yang ada, nilai yang dikembalikan adalah WHV_E_VP_DOES_NOT_EXIST. Jika prosesor virtual tidak dapat diakses dalam statusnya saat ini, nilai yang dikembalikan adalah WHV_E_INVALID_VP_STATE.

Remarks

Fungsi ini WHvSetVirtualProcessorInterruptControllerState2 memulihkan status APIC lokal dari prosesor virtual yang ditentukan dari buffer dalam format status eksternal standar, biasanya yang sebelumnya diproduksi oleh WHvGetVirtualProcessorInterruptControllerState2. Karena daftar prioritas tugas (TPR) bukan bagian dari status pengontrol interupsi hypervisor, fungsi ini juga menyinkronkan register prosesor CR8 virtual ketika TPR yang disediakan berbeda dari nilai saat ini.

Fungsi ini memerlukan emulasi APIC lokal untuk dikonfigurasi untuk partisi.

Requirements

Persyaratan Nilai
Windows minimum yang didukung Windows 10, versi 2004
Header WinHvPlatform.h
Perpustakaan WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64

Baca juga