WHvSignalVirtualProcessorSynicEvent

Сигнализирует флаг события искусственного прерывания (SynIC) на виртуальном процессоре.

Синтаксис

typedef UINT8 WHV_VTL;

typedef struct WHV_SYNIC_EVENT_PARAMETERS
{
    UINT32 VpIndex;
    UINT8 TargetSint;
    WHV_VTL TargetVtl;
    UINT16 FlagNumber;
} WHV_SYNIC_EVENT_PARAMETERS;

HRESULT
WINAPI
WHvSignalVirtualProcessorSynicEvent(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ WHV_SYNIC_EVENT_PARAMETERS SynicEvent,
    _Out_opt_ BOOL* NewlySignaled
    );

Parameters

Partition

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

SynicEvent

Указывает целевой объект события. VpIndex определяет виртуальный процессор, TargetSint идентифицирует источник искусственных прерываний (SINT), TargetVtl определяет целевой уровень доверия виртуального доверия и FlagNumber определяет флаг события, который нужно задать.

NewlySignaled

Если значение не равно NULL, получает TRUE , если флаг события переключился из очистки в результат этого вызова, и FALSE если флаг уже установлен.

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

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

Функция возвращается E_INVALIDARG , если TargetVtl нет 0. Если контроллер искусственных прерываний целевого виртуального процессора не настроен для получения событий, функция возвращается HRESULT_FROM_WIN32(ERROR_HV_INVALID_SYNIC_STATE).

Remarks

Функция WHvSignalVirtualProcessorSynicEvent задает флаг события, FlagNumber определенный на странице флага событий SynIC целевого виртуального процессора и обеспечивает прерывание, активируемое ребрами, на указанном SINT. Это механизм, используемый для сигнала гостя через порт событий SynIC.

Выходные NewlySignaled данные отличают флаг, который этот вызов задан от того, который уже ожидался.

Требования

Requirement Ценность
Минимальный поддерживаемый Windows Windows 10 версии 20H2 (x64); Windows 11 версии 24H2, сборка 26100.3915 (Arm64)
Header WinHvPlatform.h
Библиотека WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64, Arm64

См. также

  • Last updated on