WHvSignalVirtualProcessorSynicEvent

Sanal işlemcide yapay kesme denetleyicisi (SynIC) olay bayrağına işaret eder.

Sözdizimi

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

Bölüm nesnesi için tanıtıcı.

SynicEvent

Olayın hedefini belirtir. VpIndex sanal işlemciyi tanımlar, TargetSint yapay kesme kaynağını (SINT) tanımlar, TargetVtl hedef sanal güven düzeyini tanımlar ve FlagNumber ayarlanacağı olay bayrağını tanımlar.

NewlySignaled

NULL değilse, olay bayrağının bu çağrının sonucu olarak clear'ten ayarlı olarak geçiş yapıp olmadığını ve FALSE bayrağın önceden ayarlanıp ayarlanmadığını alırTRUE.

Dönüş Değeri

İşlev başarılı olursa, dönüş değeri olur S_OK.

değilse işlevi döndürür E_INVALIDARGTargetVtl0. Hedef sanal işlemcinin yapay kesme denetleyicisi olayları alacak şekilde yapılandırılmamışsa, işlevi döndürür HRESULT_FROM_WIN32(ERROR_HV_INVALID_SYNIC_STATE).

Açıklamalar

İşlev, WHvSignalVirtualProcessorSynicEvent hedef sanal işlemcinin SynIC olay bayrağı sayfasında tarafından FlagNumber tanımlanan olay bayrağını ayarlar ve belirtilen SINT üzerinde kenar tarafından tetiklenen bir kesme sunar. Bu, SynIC olay bağlantı noktası üzerinden bir konuk için sinyal vermek için kullanılan mekanizmadır.

Çıkış, NewlySignaled bu çağrının ayarlandığı bir bayrağı zaten beklemede olan bir bayraktan ayırır.

Requirements

Requirement Değer
Desteklenen en düşük Windows Windows 10, sürüm 20H2 (x64); Windows 11, sürüm 24H2, derleme 26100.3915 (Arm64)
Header WinHvPlatform.h
Kütüphane WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64, Arm64

Ayrıca bakınız