WHvGetVirtualProcessorInterruptControllerState2

Mengambil status APIC lokal dari prosesor virtual.

Important

WHvGetVirtualProcessorInterruptControllerState2 tidak digunakan lagi. Gunakan WHvGetVirtualProcessorState dengan jenis status sebagai gantinya WHvVirtualProcessorStateTypeInterruptControllerState2 .

Note

Fungsi ini hanya berlaku untuk partisi x64.

Syntax

HRESULT
WINAPI
WHvGetVirtualProcessorInterruptControllerState2(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT32 VpIndex,
    _Out_writes_bytes_to_(StateSize, *WrittenSize) VOID* State,
    _In_ UINT32 StateSize,
    _Out_opt_ UINT32* WrittenSize
    );

Parameters

Partition

Tangani ke objek partisi.

VpIndex

Menentukan indeks prosesor virtual yang status pengontrol interupsinya diambil.

State

Menerima status pengontrol interupsi.

StateSize

Menentukan ukuran State, dalam byte.

WrittenSize

Jika non-NULL, menerima jumlah byte yang ditulis ke State. Ketika buffer terlalu kecil, buffer menerima jumlah byte yang diperlukan.

Mengembalikan Nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah S_OK.

Jika State terlalu kecil untuk berisi status pengontrol interupsi, nilai yang dikembalikan adalah WHV_E_INSUFFICIENT_BUFFER, dan WrittenSize menerima jumlah byte yang diperlukan. 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 WHvGetVirtualProcessorInterruptControllerState2 mengambil status APIC lokal dari prosesor virtual yang ditentukan dalam format status eksternal standar. Ini menggantikan WHvGetVirtualProcessorInterruptControllerStatevektor mode interupsi, dalam layanan, dan mode pemicu secara berbeda dari format status eksternal standar dan tidak menyertakan daftar prioritas prosesor.

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