WHvUpdateTriggerParameters

Mevcut tetikleyici nesnesinin parametrelerini güncelleştirir.

Sözdizimi

typedef struct WHV_TRIGGER_PARAMETERS
{
    WHV_TRIGGER_TYPE TriggerType;
    UINT32 Reserved;
    union
    {
#if defined(_AMD64_)
        WHV_INTERRUPT_CONTROL Interrupt;
#endif
        WHV_SYNIC_EVENT_PARAMETERS SynicEvent;
        struct
        {
            UINT64 LogicalDeviceId;
            UINT64 MsiAddress;
            UINT32 MsiData;
            UINT32 Reserved;
        } DeviceInterrupt;
    };
} WHV_TRIGGER_PARAMETERS;

typedef PVOID WHV_TRIGGER_HANDLE;

HRESULT
WINAPI
WHvUpdateTriggerParameters(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ const WHV_TRIGGER_PARAMETERS* Parameters,
    _In_ WHV_TRIGGER_HANDLE TriggerHandle
    );

Parameters

Partition

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

Parameters

Tetikleyici için yeni parametreleri belirtir. Üye, TriggerType tetikleyicinin oluşturulduğu türle eşleşmelidir. Her üyenin tam tanımı için bkz. Tetikleyici Veri Türleri .

TriggerHandle

tarafından döndürülürken güncelleştirilecek tetikleyici nesnesinin tutamacı WHvCreateTrigger.

Dönüş Değeri

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

içindeki parametreler Parameters tetikleyici türü için geçerli değilse işlevi döndürürE_INVALIDARG. Tetikleyici türü, tetikleyici oluşturulduğunda düzeltilir ve bu işlev tarafından değiştirilemez.

Açıklamalar

WHvUpdateTriggerParameters İşlev, canlı tetikleyiciyi yeniden oluşturmadan yeniden hedef alır, böylece EventHandle tarafından döndürülen WHvCreateTrigger tetikleyici güncelleştirilmiş eylemi sunmaya devam eder. Güncelleştirme, teslime göre atomik olarak uygulanır, bu nedenle güncelleştirmeyle yarışan bir sinyal eski veya yeni parametreleri gözlemler.

Tetikleyici türü oluşturma zamanında sabittir ve bu işlev tarafından değiştirilemez. Aynı tetikleyici türü içinde, parametre alanlarından herhangi biri ( örneğin, hedef sanal işlemci, vektör veya MSI adresi ve verileri) değiştirilebilir. Farklı bir eylem türü sunmak için ile tetikleyiciyi silin ve yeni bir eylem WHvDeleteTrigger oluşturun.

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

  • Last updated on