WHvGetVirtualProcessorInterruptControllerState2

Извлекает локальное состояние APIC виртуального процессора.

Important

WHvGetVirtualProcessorInterruptControllerState2 не рекомендуется к использованию. Вместо этого используйте WHvGetVirtualProcessorState тип WHvVirtualProcessorStateTypeInterruptControllerState2 состояния.

Замечание

Эта функция применяется только к секциям x64.

Синтаксис

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

Дескриптор объекта секции.

VpIndex

Задает индекс виртуального процессора, состояние контроллера прерываний которого извлекается.

State

Получает состояние контроллера прерывания.

StateSize

Задает размер Stateв байтах.

WrittenSize

Если значение не равно NULL, получает количество байтов, записанных Stateв . Если буфер слишком мал, он получает необходимое количество байтов.

Возвращаемое значение

Если функция выполнена успешно, возвращается S_OKзначение.

Если State слишком мало, чтобы содержать состояние контроллера прерывания, возвращается значение WHV_E_INSUFFICIENT_BUFFERи WrittenSize получает необходимое количество байтов. Если VpIndex не определяет существующий виртуальный процессор, возвращается WHV_E_VP_DOES_NOT_EXISTвозвращаемое значение. Если виртуальный процессор не удается получить доступ к текущему состоянию, возвращается WHV_E_INVALID_VP_STATEзначение.

Remarks

Функция WHvGetVirtualProcessorInterruptControllerState2 извлекает состояние локального APIC указанного виртуального процессора в стандартном формате внешнего состояния. Он заменяет устаревший WHvGetVirtualProcessorInterruptControllerStateформат, который возвращает устаревший формат, который упаковывает векторы прерывания, в службе и векторы режима триггера по-другому от стандартного формата внешнего состояния и не включают регистр приоритета процессора.

Для функции требуется эмуляция локального APIC для секции.

Требования

Requirement Ценность
Минимальный поддерживаемый Windows Windows 10 версии 2004
Header WinHvPlatform.h
Библиотека WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64

См. также

  • Last updated on